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ADVANCED NUMERICAL METHODS FOR SIMULATING 

NONLINEAR 

MULTIRATE LUMPED PARAMETER MODELS 

by 

Norbert H. Doerry 

Submitted on May 12, 1991 to the Department of Ocean Engineering in partial fulfillment of 
the requirements for the degree of Doctor of Philosophy in the field of Naval Electrical 
Power Systems. 

ABSTRACT 

Naval shipboard electric power systems are transitioning from the relatively simple 
distribution of ship service electric power to extremely complex integrated electric drive 
(IED) systems. The optimal design of warships employing IED is presently hampered by the 
lack of existing simulation computer tools for analyzing the highly coupled and controlled 
electro-mechanical systems characteristic of IED. As a first step in the development of a 
viable computer simulation tool, the numerical algorithm testing program WAVESIM was 
created. 

The key contributions of WAVESIM are the systematic treatment of waveforms as an 
abstract data type, the development of the terminal description of devices, and the use of 
structural jacobians in system reduction. 

WAVESIM represents variables by waveforms consisting of a vector of coefficients 
and a waveform type code indicating how the coefficients should be interpreted. The 
principal advantage of using waveforms over conventional discrete point methods is the 
avoidance of unstable integration techniques since for most waveform types, integration and 
differentiation are linear matrix operations. 

Devices are described in WAVESIM by relationships between terminal interface 
variables. WAVESIM recognizes two types of terminals: normal terminals having both 
potential and flow variables, and information terminals having only a potential variable. In 
this manner, WAVESIM can simulate processes involving both energy transfer and control 
signals. 

WAVESIM extends the structural jacobian matrix concept to reflect the properties of 
the dependence of system equations on system variables. The system structural jacobian 
matrix is constructed from the constitutive device structural jacobian matrices and is used to 
identfiy a sequence of smaller blocks when can be solved consecutively for all the system 
variables. 

To demonstrate and verify the capabilities of WAVESIM, several simulations were 
conducted. In all simulations, WAVESIM provide results matching data generated by other 
simulation methods. 
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Chapter 1 Introduction 

A revolution is occurring in modem warship design. The conventional mechanical 
transmission train for transferring power from the prime movers to the ships screws will be 
replaced in future warship designs by an integrated electric drive (IED) system. While 
electric drive is not a new concept, the IED approach differs significantly from previous 
electric drive implementations in that both propulsion power and ship service power (60 HZ 
440 Volts AC) are derived from the same prime movers. The resulting flexibility in the 
arrangability of the ship, in the design of the electric plant, and in the power available to 
combat systems provides the naval architect with many opportunities for significantly 
improving the combat effectiveness of modem warships. 

Designing a ship taking full advantage of the opportunities afforded by IED is not an 
easy task or even obvious. The ship designer has no precedent for an IED ship let alone the 
design of an IED electric plant. Instead, the designer must rely heavily on simulations of 
proposed systems to evaluate the soundness of the design. For the electrical power system, a 
suitable simulation environment must be capable of addressing these questions: 

Will the Electric Power System Work? 

This is the ultimate question which needs to be answered. Unfortunately defining 
the term work is not an easy task, nor is assuring a system will work under all operating 
conditions. A strict time domain simulation only provides a solution for a given set of 
operating conditions. Generalizing the results of relatively few simulations to all 
operating conditions is both necessary and prone to catastrophic failure. Hence more 
than just a time response is usually needed. 

How Will (he System React (o Major Disturbances and Faults? 

The primary design goal for shipboard electric power systems is continuity of 
power. To this end, the response of the system to abnormal events such as grounds, 
stalled motors, and inadvertent opening of breakers is crucial to evaluating the success 
of the electric power system design. 

How Will the System React to Severe Dynamic Conditions? 

A number of normal events can cause severe dynamic responses within the 
system. Rapidly changing the propulsion motor speed or direction, discharging pulse 
weapons, or starting large motors are all examples of normal dynamic events. 
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Is the System Stable During a Given Dynamic Scenario? 

One import aspect of a system that works is its stability. The system should 
remain stable during all normal dynamic conditions and for as many disturbances and 
faults as possible. 

What is the Stability Margin? 

Some measure of how stable the system is should be provided to assist in 
generalizing the findings of stability about one scenario to other related scenarios. 

What is the Sensitivity of the Results to Parameters? 

The generation of models for a dynamic system simulation requires some 
estimation of device parameters. Knowledge of the sensitivity of the simulation results 
to parameter estimation errors is crucial for correlating simulation results with what can 
be expected from the physical system. 

How Correct are the Answers Provided to the Above Questions? 

Simulations generally use numerical methods to generate solutions. Careful 
control of error propagation is very important in ensuring accurate conclusions can be 
drawn from the simulation results. Some form of feedback should be provided to the 
operator as to the confidence level of the results. 

These requirements for performing time domain simulations of proposed and existing 
electric power systems found on United States naval warships can be quite challenging. The 
size, complexity, and strong coupling of components all conspire to make the simulator’s 
task difficult. At first glance, one would think the simulation programs designed for the 
commercial power utilities would be sufficient for handling the smaller shipboard systems. 
Unfortunately, this is not the case due to the following differences of the shipboard system 
from commercial power systems: 

Variable Frequency 

Frequency cannot be assumed constant. Many IED designs have the generators, 
motors, and ship service power all operating at different frequencies to optimize the 
performance of individual components. Frequency changers are employed to convert 
the power from one frequency to another. Even the ship service system onboard 
mechanical drive ships can experience frequency fluctuations lasting up to 2 seconds. 
The limited rotational intertia of the prime movers and generators allows for rapid 
accelerations and decelerations of the shaft and corresponding frequency fluctuations. 
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Lack of Time Scale Separation 

The principal time constants of controls, machine dynamics, and electric 
dynamics all fall within the same general range of milliseconds to seconds. The 
practice of decomposing the problem by time scale separation often used in analyzing 
commercial power systems becomes much more difficult. 

Load Sharing instead of Power Scheduling 

The commercial power utilities operate by scheduling the power delivered by 
each of the generating units. The mismatch between scheduled power generation and 
the actual load is met by a swing generator. Onboard ship however, both real and 
reactive power are shared equally among all paralleled generators through the very fast 
exchange of load sharing information. This fast exchange of information strongly 
couples the dynamics of all the paralleled generators. 

Short Electrical Distances 

The distances onboard ship are so short (under 1000 ft) as to make the modelling 
of transmission lines unnecessary for most simulations and to trivialize the load flow 
problem which is so important to the commercial power sector. The short electrical 
distances also strengthen the coupling of the various subsystems making up the 
electrical power system. 

Load Dynamics 

Commercial utilities usually assume loads are either consuming constant real and 
reactive power, or are constant impedances. Shipboard systems however, must account 
for dynamics of loads such as propulsion motors, large pumps, pulsed loads, propeller 
dynamics, and ship dynamics. Furthermore, the supervisory level control envisioned 
for future designs may have the ability to control aspects of the loads in addition to 
generation. 

Tighter Control 

Because a ship is relatively small, a higher level of control can be exercised over 
the shipboard power system than can be exercised in the commercial power industry. 
This higher level of control strengthens the dynamic coupling of components of the 
system and complicates simulation efforts. 

Clearly, shipboard systems are considerably different from commercial pow'er systems; 
and the inapplicability to shipboard power systems of simulation techniques developed for 
commercial systems should not be surprising. Other simulation tools exist but for one or 
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more reasons, all are ill-suited for simulating shipboard systems. A review of currently 
available commercial software for solving lumped parameter systems reveals no program 
currenty exists suitable for fulfilling the needs of simulating shipboard electric power 
systems. 

Circuit Simulators 

As will be discussed in following sections, circuit simulators almost universally 
describe devices in terms of branch voltages and currents. The constitutive 
relationships are based only on the relative difference of the terminal variables and can 
not depend on the actual nodal potentials. Furthermore, the flow variables must be 
conserved on the device level. While these restrictions are not of concern for electrical 
networks, they are a bit constraining on electro-mechanical systems where one would 
like to deal with energy transformations in a device by employing equations which do 
not conserve the flow variable on the device level. The torque on the input shaft of a 
gearbox for example, does not equal the torque on the output shaft. Even electric 
power models where the flow variable is power and the potential variable is voltage can 
best be described by constitutive equation which do not enforce conserving power by 
ignoring the power converted to heat through resistive losses. 

Many circuit simulator also have problems modelling the transfer of infonnation 
which is common in systems employing control systems. Information has only 
potentials and no flows associated with it. 

Signal Analysis Software 

Signal Analysis Software is often used to simulate control systems but often have 
difficulty simulating energy transfer. In particular, these programs often are incapable 
of solving implicit equations which are typically created by writing Kirclthoff ’s Current 
Law when developing systems. Instead much effort must be expended to ensure the 
models have the appropriate input and output variables for a given system to be built. 

Commercial Power Utility Analysis Programs 

Software for analyzing commercial power universally do not apply to shipboard 
systems due to several key differences. The lack of transmission lines, rotational 
inertia, time scale separation of dynamics and the presence of tightly coupled control 
loops are all features of the shipboard system which prevent the use of the commercial 
power system analysis techniques [5] [9] [10] [11]. 
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General Differential Equation solvers 

Most general differential equation solving programs cannot handle implicit 
equations very well. While the development and interconnecting of models into 
systems is possible, the process can be quite cumbersome [12] [13]. Dynamically stiff 
systems also pose serious challenges to the general differential equation solvers. 

Hybrid Computers 

Hybrid computers for studying electrical power systems can answer many of the 
desired questions for small shipboard systems. Unfortunately, hybrid computers are 
very expensive and limited in the size of problems which can be addressed. Presently 
the only hybrid computer in the United States suitable for shipboard power system 
studies is located at Purdue University. While this machine is capable, the needs of the 
IED program will require digital computer techniques for performing the desired 
studies. [92] [93] [94] [95] [96] 

As part of an effort to fill the need for simulating shipboard power systems, the 
WAVESEM program was specially created to develop applicable simulation techniques. 
Before discussing the numerical methods employed in WAVESEM, a review of existing 
methods is appropriate. 

1.1 Simulation Process 

The process of simulating a physical system can be broken into three steps. First, a 
system of equations describing the component device constitutive relationships as well as 
the network constraints must be developed. While the network constraints are purely linear 
algebraic equations, the constitutive equations can be nonlinear and dynamic. Together, a 
system of nonlinear differential algebraic equations is generated. The next step is the 
conversion of the system of differential algebraic equations into a sequence of purely 
algebraic equations. Common integration techniques include the forward and backward 
Euler methods. Trapezoidal mle integration, and the Runge-Kutta methods. Finally, the 
nonlinear algebraic system is solved either through the Newton-Raphson method or through 
one of several relaxation techniques. 

Before describing several methods for generating and solving the system of equations 
corresponding to a physical system, the difference between the branch description and 
terminal description of devices should be detailed. The branch description of devices 
requires all the constitutive relationships be based on the relative difference between 
terminal potentials and all flows entering a device also leave the device. Hence for a two 
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terminal device, there is a single branch potential variable and a single branch flow variable 
associated with it. In the terminal description, the potential and flow associated with each 
terminal are variables. A two terminal device would then have four variables associated 
with it: two flow variables and two potentials. The terminal description allows the 
constitutive equations be a function of the actual values of the terminal potentials and not 
only of the potential difference. In other words, the potential reference can be set at the 
system level and not necessarily on the device level. Furthermore, the flows are not 
required to be conserved. A gear box for example, has differing torques entering and 
exiting it. The branch description method requires a four terminal model of the gear box 
while the terminal description requires only two terminals. In either case the result would 
be four variables describing the gearbox, but the branch description requires an explicit 
declaration of the device potential reference while the terminal description uses an implicit 
system wide potential reference. 

Branch Description vs. Terminal Description 



+ 

V 



i 



t 
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1.2 Developing System Equations 

The normal method of describing a dynamic system is to generate a consistent set of 
possibly nonlinear differential algebraic equations and arrange them into the following 
canonical form: 

Cx =f(x, y, u) 

0 = g(x,y,u) 

where x is the vector of dynamic state variables, y is the vector of state variables with no 
associated dynamics staes, and u is the vector of system inputs. This system of differential 
algebraic equations (DAE) can be generated several different ways with the most common 
being the Sparse Tableu, Modified Nodal Analysis, and the standard load flow method. 

The method employed in WAVESEM does not extract the differential equations from 
the device constitutive equations but instead forms a system of algebraic equations of the 
form: 

0 = g(x,g i (x„u l ),u) 

where x is the vector of the system variables and g,() is a device function having subsets x ; 
and 

of x and u as arguments. The functions g,{) have the dynamics of the device contained 
within them, but these dynamics are not expressed on the system level. 
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1.2.1 Sparse Tableau Method 



The Sparse Tableau method is a very general method for describing systems 
employing the branch description of devices. Proposed in [4] and used in the ASTAP and 
SPICE simulators [1][15][16], the Sparse Tableau method breaks the system equations and 
variables each into three groups. The three sets of variables are the branch currents, branch 
voltages, and the nodal voltages. The three sets of equations are the node Kirchhoff 
Current Law (KCL) equations in terms of the branch currents, Branch Voltage equations 
relating branch voltages to nodal voltages, and the Constitutive equations relating branch 
voltages to branch currents. 

Figure 1-2.1 -1 RC Example: Sparse Tableau 




0 



Figure 1.2. 1-1 shows an example of a simple RC charging circuit. Using the Sparse 
Tableau approach, the system variables are: 

is Voltage Source branch current 

i R Resistor branch current 

i c Capacitor branch current 

v s Voltage Source branch voltage 

v* Resistor branch voltage 

v c Capacitor branch voltage 

e, Node 1 potential (voltage) 

e 2 Node 2 potential (voltage) 

Note the reference node 0 is assigned a potential of 0. 
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The KCL equations are given by: 

i s + i/f =0 —i R + i c = 0 

The Branch Voltage equations are: 

v s - e x - 0 v c - e 2 = 0 

v* “ («i “ <? 2 ) = 0 

The Constitutive equations are: 
v s -V s = 0 
v R - i R R = 0 

While the Sparse Tableau approach generates a consistent set of network equations, 
the size of the system is relatively large (eight equations in eight unknowns for this 
example). Furthermore, the method employs the branch description of devices which 
complicates the development of electro-mechanical models. 



dv c 

, c -c- = ° 
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1.2.2 Modified Nodal Analysis 



The Modified Nodal Analysis method generates a compact set of system equations 
for systems of device models using branch descriptions. Modified Nodal Analysis (MNA) 
was formalized in [6], described in [1][16], and employed in the circuit simulator MSINC. 
The procedure consists of writing the KCL equations for all but the reference node in terms 
of the branch currents, replacing the branch currents wherever possible with constitutive 
equations in terms of the branch voltages, appending any remaining constitutive equations, 
and substituting the branch voltages with the corresponding nodal voltages. 



Figure 1.2. 2-1 shows a simple example of a simple RC charging circuit, the MDA 
approach would first write the KCL equations: 



Figure 1. 2.2-1 RC Example: Modified Nodal Analysis 




+ V, 



h + - o 

Substituting the constitutive relations results in: 



*r + *'c — 0 





The extra constitutive equation is given by: 
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Substituting the nodal voltage results in the system of three equations 






K (e, e 2 ) + C 



de 2 

~dt 



= 0 



e,-\/ s = 0 



While the Modified Nodal Analysis Method generates a compact set of equations, it 
does require the use of the branch description as well as the explicit definition of flow 
variables. Both restrictions can complicate teh modelling of electro-mechancial devices. 
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1.2.3 Standard Load Flow 



The Load Flow approach is traditionally used in the analysis of commercial power 
systems. For this application, the flow variables are usually real and reactive power while 
the potential variables are the voltage magnitude and phase angle. The Load Flow 
approach is a variation of nodal analysis described in many papers and texts on power 
systems including [14] [29] [31] [35] [49] [50] [76] [101]. The terminal description of 
devices is used since power flow is not conserved on the device level (The power entering 
a transmission line is not the same as the power leaving the same line). The basic 
procedure is to write the KCL equations in terms of the node potentials. Nodes with ideal 
potential sources are treated specially since their corresponding flow variable is not a 
function of the device voltages. 

Figure 1. 2.3-1 RC Example : Load Flow 




Figure 1.2. 3-1 shows a simple RC charging circuit using the terminal description of 
the devices. A load flow approach using currents as the flow variable would result in the 
following procedure: 

Write the KCL Equation at nodes without potential sources 

l R2 + l Cl ~ 0 



Substitute Constitutive relationships for the flow variables 



1 , ^ ^ d ( v ci “ v c?) A 

^ (v« “ Vri) + C = 0 
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Substiute the nodal potentials 

1 de 2 

- ie ,-v s)+ c-=o 

All the remaining variables can be calculated from the solution of this differential 
equations. The load flow method definitely creates a very compact set of equations (only 
one in this case) but requires the flow variables be defined explicitly in terms of the 
potential variables, and must treat ideal potential sources as special exceptions. Neither of 
these restrictions is attractive for a general electro-mechanical system simulator. 
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1.2.4 WAVESIM Terminal Description 



The method employed in this thesis is similar to Modified Nodal Analysis with the 
exception that terminal potentials are used instead of branch voltages and that the 
constitutive equations are only expressed on the device level and never expressed on the 
system level. Potential difference equations are appendended to the system of KCL 
equations to equate explicitly defined potentials with their node potentials. For the RC 
example, the system variables are given by: 

i SI Voltage Source terminal 1 current 

i CI Capacitor tenninal 1 current 

e 0 Node 0 potential (voltage 

e t Node 1 potential (voltage) 

e 2 Node 2 potential (voltage) 



Figure 1.2.4-1: RC Example: Terminal Description 




R 



The KCL Equations for the RC example are given by: 



ht+gRJK i(«..«2) = 0 



'ci+SnjRii.* P«2) = 0 



! G 8s_iS2^Sl * e o) 8c_iC2^Cl ' ^o) ~ 0 
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The Potential Difference Equations are given by: 

e 2 ~ 8c_vci Oc; > e o) — 0 

— 8s_vSl * ^o) = 0 
^0 — £g_vc(*g) = 0 



Note that a reference device allowing for a more general method of setting the 
system reference points is employed rather than a reference node. While the number of 
equations is twice that of the Modified Nodal Analysis method, flows need not be 
conserved on the device level. Furthermore, the system of equations is easily partitioned 
into a sequence of five blocks for a more rapid solution (two lxl blocks, followed by a 
2x2 block, followed by two more lxl blocks). 
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1.3 Solving System Equations 

As stated earlier, the standard approach to simulating a physical system is to generate 
a system of differential algebraic equation of the form: 

Cx =f(x,y,u ) 

Q = g(x,y,u) 

To solve this system, it must first be converted to a system of purely algebraic 
equations by substituting the differential equations with discrete approximations. The time 
history of a variable is expressed as a series of discrete points in time where dynamics are 
expressed as algebraic relationships between the values of a variable at different discrete 
times. Standard methods for performing this approximation include the forward and 
backward Euler, Trapezoidal rule integration and Runge-Kutta methods. 

The major problem with this approach is the dependence of the time step on the fastest 
mode (smallest eigenvalue) of the dynamic system. This forces the entire system be solved 
with a very fine discretization of time, even though large portions of the system are not 
affected by the fast mode. 

In any case, the system of nonlinear algebraic equations must be solved. The two 
classes of solvers most commonly used are variations of the Newion-Raphson Method and 
several relaxation methods. 

1.3.1 Newlon-Raphson Method 

The Newton-Raphson method works well for most systems as long as the initial 
guess for all of the variables are within the convergence region of the final solution. This 
method is used in SPICE and ASTAP and is based on a Taylor series expansion of the 
system of equations: 

F(x) = 0 = F(x k ) +J(x k )A k + ... 

Xk + i=X k + & k 

A k = -r\x k )F(x t ) 

The matrix J is called the Jacobian Matrix and its inverse must exist for the 
method to work. 



-25 - 



1.3.2 Relaxation 



Relaxation methods assign one of the system variables to each of the system 
equations. After initial guesses are made for each of the variables, the variables are 
updated by solving their corresponding equation assuming none of the other variables have 
changed. The two most popular relaxation methods are the Gauss-Jacobi (popular with 
parallel processing computers) and the Gauss-Seidel method (usually used with serial 
processing computers). The Gauss-Jacobia calculates updates for all the system variables 
before actually performing the update: 



F(x) = 0 






The Gauss-Seidel method updates the system variables as the updates are calculated: 

F(x) = 0 

F,iK k + 1 ,X 2tt + l , + .*] ) = 0 



1.3.3 Waveform Relaxation 



An alternate method to solving the dynamic equations system wide is to solve them 
equation by equation over a given time interval. The Waveform Relaxation method 
represents variables by a sequence of points representing the time history of the waveform 
over a given time interval. Each variable can be discretized differently and is assigned one 
of the system equations. The system equations are solved over the waveform interval for 
their assigned variable with the other variables held at their current waveform values. 

Waveform Relaxation works well with loosely or directionally coupled systems, but 
does not work well for tightly coupled systems. The method does however, have good 
multirate performance since each differential equation can be solved using a time 
increment appropriate to it. 

1.3.4 WAVESIM Approach 

To summarize the traditional solving methods, the standard methods employing 
Netw'on-Raphson can handle tightly coupled systems but perform poorly with multirate 
systems while waveform relaxation performs poorly with tightly coupled systems but 
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efficiently solves multirate problems. Unfortunately, the shipboard systems have both 
multirate and tightly coupled properties. For this reason, WAVESIM combines the 
Newton-Raphson method with a waveform representation of variables. 

In WAVESIM variables are represented over a time interval by a vector of 
coefficients along with a type indicator for specifying how the coefficients should be 
interpreted. Common interpretations include Legendre Series coefficients, Chebyshev 
Series coefficients, and polynomial series coefficients. For these representations, 
integration and differentiation are linear matrix operations and the issue of numerical 
stability of an integration technique disappears. Waveforms can usually be converted 
from one type to another with a linear matrix operation as well. 

With variables represented as vectors of coefficients, the Newton-Raphson method 
can be employed for solving tightly coupled systems. Good multirate performance is 
achieved through the linear matrix operator for integration along with waveform 
smoothing to average out phenomena faster than the time scale of interest. 

1.4 Thesis Outline 

This thesis focuses on developing a digital computer simulation environment suitable 
for studying shipboard electric power systems. WAVESIM, a simulation program written 
in the C programming language demonstrates algorithms for simulating systems of 
nonlinear lumped parameter models representing the electro-mechanical components 
composing an IED system. The key features of WAVESIM are: 

Devices defined independent of the encompassing systems 

Devices can be developed and tested without an exact knowledge of the 
topology of the systems incorporating the devices. 

Devices described using the Terminal Representation of devices 

Device constitutive relationships are written in terms of the actual values of the 
terminal potentials and not in terms of relative potentials. In this manner, device 
equations can be written in terms of a system reference when such a reference level is 
unambiguous. Furthermore, the flow variables are not required to be conserved on a 
device level. This greatly eases the task of modelling flows which also depend on a 
reference potential (power for example). 
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Devices defined independent of the manner in which terminal interface variables 
are expressed. 

Devices can be developed without specifying how the interface variables are 
specified. In WAVESIM, variables can be represented many different ways, all of 
which are irrelevant to the specification of the constitutive equations making up the 
device. 

System equations instead of the devices resolve input-output conflicts. 

WAVESIM does not constrain normal terminals where energy is transferred 
from having more than one output hooked together at a node. 

Interface Variables represented by waveforms 

Waveforms are a vector of coefficients which specify a given variable over a 
given time interval instead of a single value describing the variable at a given point in 
time. The waveform type determines how the coefficients should be interpreted for 
generating values of the variable within the time interval. Representing variables as 
waveforms has the primary benefit of removing the issue of numerical stability of 
integration techniques from the simulation. Integration and differentiation are merely 
operators on waveforms, no different from addition, subtraction, or any of the 
trigonometric operators. 

Differentiation and Integration performed on the device level instead of the 
system level. 

Most circuit simulators as described in the previous sections solve the 
differential equations associated with device constitutive equations on a system level. 
This method eases the task of evaluating the stability of linear systems but introduces 
new problems. If the eigenvalues of a dynamic system are widely separated in value, 
the simulation time step must be made very small for the entire system if conventional 
integration techniques are employed. WAVESIM solves the differential equations on 
the device level and employs waveform smoothing to remove dynamics which occur 
faster than the time scale of interest. 

While many of the pieces of WAVESIM are not new', several key concepts are 
presented in this thesis for the first time: 

The Terminal Description of devices 

Instead of specifying the interface of devices by pons consisting of a potential 
difference (branch voltage) and the flow through the potential difference (branch 
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current), the terminal description of a device assigns a potential and a flow entering 
the device for each normal terminal. Simulators based on branch voltages and 
currents require all of the flow entering a device to also leave the device. In this 
sense, the flow is conserved. The terminal description however, does not require 
conservation of flow within a device (Conservation of flow as expressed by 
Kirchhoff’s Current Law - KCL is required at connection points called nodes). The 
ability to construct models which do not conserve flows can simplify models where 
energy transformations occur, the reference potential is clearly known for the system 
and not just for the device, and certain forms of energy are not of interest. In many 
mechanical simulations for example, the amount of energy lost in friction is not of 
interest to the modeler. A simulation model based on branch potentials and flows of a 
device experiencing friction would be required to reject the frictional heat through one 
of its branches. 

The tenninal description also allows for the transfer of information between 
devices through information nodes and infonnation terminals. This feature is 
essential for successfully modelling many control algorithms. The ability to mix 
control signals and energy transfer through flow variables within the same simulation 
environment is a major advantage of the terminal description. 

The Structural Jacobian method for building and reducing systems 

The concept of the connection matrix for specifying the participation of system 
variables in system equations is expanded to include the structural form (i.e. diagonal, 
linear, nonlinear, etc.) of the dependence of the system equations on the system 
variables. The codes for the structural Jacobian adhere to a simple set of algebraic 
rules which can be used to construct a system structural Jacobian matrix from the 
individual device structural Jacobians. The system structural Jacobian facilitates the 
reduction of the numerical effort required to solve the system by identifying and 
characterizing a set of smaller blocks which when sequentially solved, determine all 
of the system variables. The system structural Jacobian can also be used to detect 
unconnected systems and indicate possible potential reference problems. 

The Systematic Treatment of Waveforms as an abstract data type 

WAVESIM departs from the conventional paradigm of representing variables in 
a dynamic simulation by a series of discrete points in time with a new paradigm based 
on representing variables as a sequence of waveform intervals. Within each 
wavefonn interval, the value of the waveform can be directly determined for any time 
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based on a vector of coefficients, a wavefonn type indicator for specifying how the 
vector of coefficients should be interpreted, and the time boundaries of the wavefonn 
interval. Devices are defined independent of the waveform type of the terminal 
variables. The principle advantage of using waveforms is that integration and 
differentiation are simple operators. The integral of a waveform is just another 
waveform. Simulation time steps are no longer controlled by the requirement for 
numerical stability of the integration technique. Instead, series truncation error 
control becomes the primary concern of the simulation environment. The ability to 
use arbitrary waveform types and convert between types allows the modeler to use the 
most appropriate waveform representation for the modeling problem. 

This thesis is composed of six chapters including this introduction. Chapter Two 
describes in some detail the specific properties of current shipboard electric power systems 
and proposed integrated electric drive systems. Chapter Three provides a framework of 
theory for developing the simulation environment WAVESIM and is broken into five 
subsections. The first subsection details the Terminal Description method for modelling 
devices. The second subsection demonstrates how to interconnect device models into 
systems, construct the system structural Jacobian, and generate a sequence of blocks for 
solving the system equations. The third subsection covers the treatment of waveforms as an 
abstract data type. Solving the system of equations employing wavefonns is detailed in the 
fourth subsection. The fifth and final subsection of the third chapter covers modelling 
techniques and considerations not covered in previous sections. The actual WAVESIM 
implementation of the concepts developed in the third chapter are described in the fourth 
chapter. The fifth chapter presents results of several simulations conducted with 
WAVESIM. The final chapter provides an assessment of the work presented here as well as 
possible future developments. 

The appendices support the main chapters. Appendix A is a glossary of terms used 
through out this thesis. Appendix B details some possible problems with using continuation 
parameters. Appendices C and D are Load Flow examples of the terminal description 
method. Appendix E provides examples of waveform types and a number of operators for 
them. Appendix F presents a number of models useful for conducting shipboard power 
system simulations. Finally, Appendix G details the program files making up WAVESIM. 

This thesis introduces a number of new terms. To assist the reader, the first occurance 
of a new tenn is indicated by the distinctive Helvetica typeface. MATLAB variable names 
and sample sections of C programs are printed in Courier. 
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Chapter 2 Shipboard Electric Systems 
2.1 Typical Shipboard Electric Distribution System 

The electric power systems onboard naval warships differ considerably from the 
integrated power utilities found in developed countries. The differences arise from the 
small size of the shipboard systems and contrasting standards for optimization. Shipboard 
systems are optimized for survivability and minimization of weight and volume. Power 
utilities on the other hand optimize for reliability and minimization of cost. The unique 
characteristics of the shipboard systems result in markedly different design requirements 
and standards as compared to power utilities. 

Frigates, destroyers and cruisers are relatively small warships with corresponding 
small electric power systems. Frigates normally displace from 2000 to 4000 long tons 
(1 long ton = 2240 lbs) and have a primary mission of escorting merchant convoys. In the 
U.S. Navy, frigates have only one propulsion shaft and about half the armament of a 
destroyer. Destroyers displace from 4000 to 7500 long tons and are designed as escorts for 
aircraft carrier battle groups. Cruisers are larger than destroyers, displacing from 6000 to 
16000 long tons, carry more weapons, and are used to provide aircraft carrier battle groups 
with integrated anti-aircraft and anti-cruise missile defenses. U.S. Navy cruisers and 
destroyers all have two propulsion shafts. 

The installed electric plant capacity for U.S. warships has varied from 3000 KW to 
4500 KW per propulsion shaft over the past twenty years. Generally, the newer ships have 
more installed capacity. Figure 2.1-1 shows the electric plant characteristics for the major 
classes of conventionally fueled frigates, destroyers and cruisers constructed in the past 
twenty years. All the listed ships with the exception of the Knox class frigates use 
mechanically coupled gas turbine propulsion. The Knox class frigate is the last class of 
conventionally fueled warships to use 1200 psi steam for main propulsion. (All nuclear 
powered ships use 600 psi steam). Most of the Knox class frigates are presently being 
transferred to the reserve forces or being decommissioned. 
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Figure 2.1-1 U.S. Navy Ship Characteristics 


Ship Class (Nbr) 


Name 


KW 


Generator Type 


Year 


FF-1052 Frigate 
(46) 


Knox 


4 x 750 KW 


3 Steam Turbine 
1 Diesel 


1969 


FFG-7 Frigate 
(51) 


Oliver Hazard 
Perry 


4 x 1000 
KW 


4 Diesel 


1977 


DD-963 Destroyer 
(31) 


Spruance 


3 x 2000 
KW 


3 Gas Turbine 


1975 


DDG-993 Destroyer 
(4) 


Kidd 


3 x 2000 
KW 


3 Gas Turbine 


1981 


DDG-51 Destroyer 
(1 + 28) 


Arleigh Burke 


3 x 3000 
KW 


3 Gas Turbine 


1991 


CG-47 Cruiser 
(19 + 8) 


Ticonderoga 

"Aegis" 


3 x 2500 
KW 


3 Gas Turbine 


1983 



Figure 2.1-2 Shipboard Electric Distribution System 
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Figure 2.1-2 shows a typical ring bus architecture found on modem warships. The 
small size of the shipboard system results in many differences with respect to commercial 
systems. As a consequence the analysis of the shipboard plant requires recognition of these 
differences: 

1. Power Quality requirements relaxed relative to commercial 

standards. Constant frequency and voltage assumptions 
can not be made. See section 2.2 for more details. 

2. Very little Rotational Inertia require fast controls to 

maintain frequency. Infinite bus assumption does not hold. 

3. Transmission lines are very short and for the most studies, 

can be ignored. 

4. No scheduling of real or reactive power. All generators 

are loaded in equal proportion to their rating. 

Load Flow solution has little meaning. 

5. Load sharing information communicated to all online generators. 

6. Large loads (relative to the size of generation plant) present. 

Start up transients (load dynamics) are important. 

7. Power Electronic Switching loads are significant. 

8. Load shedding strategies are minimal. 

Figure 2.1-2 also indicates the requirement for a simulation environment to include 
the ability to model more than just electric power phenomena. Modelling shipboard 
systems also requires extensive representation of mechanical dynamics as well as energyless 
information transfer between components. This requirement is significant in that simulation 
packages for commercial power systems do not include this capability as an integral part of 
the simulation environment design. 

2.2 Shipboard Electric Plant Standards 

The primary standards for designing a shipboard electric plant are contained in the 
following references: 

Department of Defense, Interface Standard for Shipboard Systems, Section 300A, 
Electric Power, Alternating Current (Metric), MIL-STD-1399(NAVY), 13 
October 1987. 
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Department of the Navy, General Specifications for Ships of the United States Navy, 
Section 300, General Requirements for Electric Plant, Naval Sea Systems 
Command, 1987. 

Department of the Navy, General Specifications for Ships of the United States Navy, 
Section 320, General Requirements for Electric Power Distribution Systems, 
Naval Sea Systems Command, 1987 

The goal of electric power utilities is to provide a reliable source of high quality 
electric power at minimum cost. Shipboard systems on the other hand are designed to 
provide a survivable and continuous source of electricity. Quality and cost are secondary 
issues. Figure 2.2-1 summarizes the minimum quality of power a shipboard system must 
provide 

Figure 2.2-1 clearly demonstrates the quality of power guaranteed onboard a warship 
is considerably lower than the quality of service provided by power utilities. Figure 2.2-1 
does not show however, how often the transient conditions occur. This infonnation is 
provided by MIL-STD-1399 and summarized in figure 2.2-2. A major ramification of the 
low quality of power provided by the ship service electric system is that loads must be 
designed to operate and survive wide ranges of voltage and frequency fluctuations. This is 
one of the reasons why commercial equipment often can not be directly installed onboard 
ships (Shock requirements are also a major factor). Sensitive loads must provide their own 
filtering and protection circuitry. This militarization of equipment can add considerable 
cost and complexity to warship design, outfitting and maintenance. 
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Figure 2.2-1 : Shipboard Electric Power Quality Standards (MIL-STD-1399) 


Frequency 


Nominal 


60 Hz 


Tolerance 


±3% 


Modulation 1 


0.5% 


Transient Tolerance 


±4% 


Transient Recover Time 


2 seconds 


Worst Case Excursion 


+ 5.5 % 


Voltage 


Nomina] 


440/115 Volts 


Tolerance of 3 Phase Ave 


±5% 


Tolerance of any 1 Phase 


+ 7% 


Line Voltage Unbalance 2 


3% 


Voltage Modulation 


2% 


Transient Tolerance 


± 16 % 


Maximum Departure Voltage from 


±6% 


combination of 3 Phase Ave. and 




Voltage Modulation 




Worst Case Excursion 


±20% 


Recovery Time 


2 Seconds 


Voltage Spike 3 


2500/ 1000 Volts 


Voltage Waveform 


Max Total Harmonic Distortion 4 


3% 


Max Single Harmonic 


2% 


Max Deviation Factor 5 


5% 


Emergency 


Frequency Excursion 


-100% to +12% 


Voltage Excursion 


-100 % to +35 % 


Duration 


2 Minutes 



1 Modulation (percent) = — — 100 measured over a period of 1 to 10 seconds. 

2 Line Voltage Unbalance is the difference between the largest line to line voltage and the 
smallest line to line voltage divided by the nominal voltage. 

3 A Voltage Spike is a voltage change of less than 1 ms duration. 

4 Total Harmonic distortion is the ratio of the rms value of the residue (after elimination of 
the fundamental) to the rms value of the fundamental. 

5 Deviation Factor is the ratio of the maximum difference between corresponding ordinates 
of the waveform and an equivalent sine wave to the magnitude of the equivalent sine wave. 
The equivalent sine wave is defined as having the same frequency and mis voltage as the 
wave being tested. 
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Figure 2.2-2 Shipboard Electrical Reliability 


Voltage Transients of 10% or less 
Voltage Transients of 10% to 16% 
Voltage Spikes above 200 Volts 


Several times an hour 
Several times a day 
About once every 3 hours 



The basic reason for the low quality of power onboard ship is the lack of rotational 
inertia in the power system. In the commercial sector, the inertia of all the generators in the 
network add up to such a large number that no single fault can cause a frequency 
disturbance system wide. Onboard ship however, generators are often operated 
independently. Other than the inertia provided by motors, the only source of rotational 
inertia is the one generator. Since the generators are not very large, sudden load changes 
and faults can cause significant disturbances. Although speed governors and voltage 
regulators have improved significantly in the past twenty years, there is presently no way to 
prevent the transients from happening. 

The frequency tolerance limits in the steady state are rarely ever approached in 
modem warships. The rather loose tolerances allowed the use of droop governors to stably 
share loads. The electric plant operator on older ships could increase the load on a 
paralleled generator by increasing the base frequency set point on the mechanical speed 
governor. Adjusting the system frequency without changing the load sharing ratios required 
adjusting the base frequency set points on all the generator speed governors. On modem 
warships, all the generators normally operate isosynchronously and perform load sharing by 
transmitting load current information to Governor Control Units which provide feedback to 
the Asynchronous governors. 

2.3 Shipboard Electric Plant Design 

In the commercial sector, the design of electric generation and transmission capacity 
are done continuously. Ships on the other hand, have a finite life (typically thirty years) and 
the expense of upgrading the capacity of the electric plant and distribution system once the 
ship is built is usually prohibitive. In this sense, capacity expansion onboard ships is not 
done. Instead, excess capacity is initially installed to account for projected growth in load. 

The maximum load for a ship design is detennined by tabulating every load in an 
Electrical Load Summary and summing up the power requirements under different 
operating conditions. The maximum projected load usually occurs when the ship is in battle 
condition and the ambient temperature is low (Electric heaters are used in many areas of a 
ship). To account for uncertainty in estimating loads, a 20 % margin is added to the 
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maximum projected load. Another 20 % margin is added for capacity expansion 
requirements. Ninety percent of the capacity of all but one of the installed generators must 
meet or exceed the margined maximum projected load. The ninety percent requirement 
allows for imprecise load sharing when at maximum load while the all but one requirement 
accounts for taking one generator offline for maintenance. 



Figure 2.3-1 

U.S. Ships - Electrical Loads 




DD963 CQ47 DOG51 

££§3 Proputston PXX Etoctrica) Aux System* r xY HVAC XX" Combat System* 



Once the size of the electric plant is determined, there are a number of other 
considerations that must be accounted for. GENSPECS 6 require the system be ungrounded 
and based on Split Plant Operation (Each generator operating independently) with the 
capability for parallel operation. Electromagnetic Interference (EMI) and Electromagnetic 
Pulse (EMP) requirements place further constraints on the electric plant design and are 
detailed in MJL-STD-461 and MIL-STD-1310. Since warships are designed for combat, 
they must also be capable of surviving severe mechanical shocks from exploding ordnance. 
The shock requirements are particularly important for electrical equipment such as circuit 
breakers and generators. Specific requirements for shock are listed in MIL-STD-901. 



6 General Specifications for Ships of the Unites States Navy 
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A number of loads onboard a ship are very important for survival of the ship and crew 
during combat and emergencies. These loads are designated vital loads and must be 
provided with primary and alternate sources of power. Some of the vital loads have 
automatic bus transfer switches (ABT) which switch to the alternate source automatically 
on loss of the primary source. Others use manual bus transfer switches (MBT). Examples 
of vital loads include: 



Collective Protection System Class W 
Ventilation 


ABT 


Emergency Communications 


MBT 


Emergency Lighting 


ABT 


Fire Pumps 


ABT 


AFFF Pumps 


ABT 


Interior Communications 


ABT 


Machinery Space Circle W Ventilation 


MBT 


Steering Gear Auxiliaries 


ABT 


Surface Search Radar 


MBT 


VHF Bridge-to-Bridge Radio 


MBT 


Vital Propulsion Auxiliaries 


MBT and ABT 


Auxiliaries to support generator prime 


MBT 



movers 



From a naval architectural viewpoint, the placement of electric generators requires a 
number of compromises. Placing the heavy generators as low as possible is beneficial for 
hydrostatic stability purposes. The lower the generator however, the more volume is 
required for intake and exhaust ducting. Gas turbine generators are lighter than diesel 
generators, but require greater volumes of air. Furthennore, design requirements exist for 
separating 50 % of the installed capacity by two watertight bulkheads and installing a 
minimum of three generators. Generally, weight can be minimized by using the smallest 
number of generators (three). However, if four generators are used, the generators can be 
located in two machinery spaces instead of three. By using only one set of intake and 
exhaust ducts, volume for ductwork can also be reduced. Since most recent ships have had 
weight constraints placed on them by Congress, the minimum number of generators have 
been used. 7 



7 A very simple cost model for warships assigns a cost per ton of different components of a 
ship. With this in mind Congress has in the past placed constraints on the weight of ships in 
order to keep costs down. 
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Enclaving is a concept for arranging ships which involves locating all the equipment 
required for a given combat system within the same general area of the ship. If a ship is 
completely divided into a number of enclaves, one enclave can be damaged by enemy 
ordnance while the others remain functional and capable of continuing the engagement. To 
work properly, this concept requires the enclaving of sources of distributed services (such as 
electricity, cooling water, fire fighting water and dry air). Presently, enclaving has not been 
incorporated in any warship design but its use has been proposed for a number of new 
designs 8 . If enclaves are ever used, they will have a significant impact on the type, size, 
number, and location of electric generators. In some enclaves it may not even be possible to 
locate a conventional generator. Alternate generating or storage devices such as fuel cells 
or batteries may be used. 

2.4 Integrated Electric Drive 

Most modem warships mechanically couple the main propulsion prime movers with 
the propeller shaft. The mechanical power train is very efficient but imposes constraints on 
machinery arrangement and adversely impacts survivability. The prime mover is usually 
very heavy and must be located near the center of the ship to prevent excess trim. Shafting 
must therefore penetrate a number of watertight boundaries and maintain precise alignment 
over a great distance. The long length and precision requirements of the shafting make it 
very vulnerable to weapon induced damage. While electric propulsion eliminates many of 
the survivability and arrangement constraints of the mechanical system, the propulsion 
system must be carefully designed to ensure overall plant efficiency is not degraded by the 
extra power conversion losses in converting to and from electric power. Designed properly, 
an electric drive system can achieve the survivability and arrangeability benefits without 
suffering from a lower propulsion plant efficiency. 

Integrated electric drive interconnects the generation of power for propulsion with the 
generation of ship service electric power. The propulsion plant for U.S. warships typically 
averages between 30 and 37.5 MW per shaft. The capacity is sized to provide enough 
power to propel the ship at a desired maximum speed. Most ships however, do not operate 
for extended periods of time at maximum speed. Operating at half maximum speed requires 
only about 20 percent of the installed power and quarter maximum speed requires only 2 or 



8 Enclaving requires a greater redundancy of equipment which results in the ship becoming 
larger and more expensive. Since most ship designs are cost constrained, enclaving 
provisions are often deleted to reduce the per unit price of the warships. 
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3 percent. Thus a 28 knot frigate with a 30 MW plant could go 7 knots using less than 1 
MW of power and 14 knots with about 6 MW of power. If the propulsion plant consists of 
two 15 MW generators, one generator could easily supply all the required power for both 
propulsion and ship service at the normal operating speeds of 12 to 15 knots. This has the 
potential of reducing the fuel consumption of warships under normal operating conditions 
by improving the overall efficiency of the power plant even though the efficiency of the 
power transmission system is lower. By careful selection of generator number and size, one 
can tune the overall efficiency of a plant for optimization at several different speeds. In the 
U.S. Navy, optimizing plant efficiency for 20 knots is beneficial since this is the speed used 
to calculate the amount of fuel carried by the ship. 9 

In a typical integrated electric drive scheme, the propulsion prime movers are 
connected to both a propulsion generator and to a ship service generator (PDSS or 
Propulsion Derived Ship Service). The speed of the generator is set to optimize efficiency 
of the prime mover at the given power loading. Consequently, cycloconverters are used to 
convert the power to either 60 Hz for ship service, or to whatever frequency the propulsion 
motors require. Usually, an additional diesel or gas turbine ship service generator is 
included to provide power in port or during emergencies. Figure 2.4-1 shows a typical 
PDSS design for a two shaft frigate sized ship. 

Figure 2.4-1 emphasizes the need to model mechanical dynamics and control 
information signals. The control signals can couple the dynamics of different devices 
within the system and must therefore be carefully modelled. The control signals can also 
destroy such properties as diagonal dominance which makes analysis of commercial power 
systems much easier. 

One of the features of an electric drive system which may be exploited in the future is 
the ability to divert all of the propulsion power capacity from propulsion to some sort of 
high power combat system. Weapons such as rail guns and high energy lasers may become 
possible. These types of weapons would be safer for the ship since the requirement to store 
large amounts of chemical explosives for propellent charges would be reduced. Energy to 
move projectiles would be stored in the form of relatively inert fuel oil instead of highly 



9 Most other navies use 1 8 knots which allows for combined plants such as CODOG where a 
diesel engine is used for cruising and a gas turbine for high speed. Unfortunately, the size 
requirement for a diesel capable of propelling a ship at 20 knots is prohibitive and results in 
U.S. warships only using gas turbines and carrying much more fuel. 
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Figure 2.4-1 Integrated Electric Drive 
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explosive chemical propellents. Switching large amounts of electric power onboard ships 
presents a number of technical challenges both in the design of physical equipment and also 
in attempts to accurately simulate the phenomena. The effect of pulse loads on the electric 
system is not a trivial simulation problem. 
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Chapter 3 Framework 

Conducting time domain simulations of systems of nonlinear lumped parameter models 
characterizing shipboard electric power systems requires an organized approach to 
developing device models as well as network equations. The major contribution of this 
thesis is the development of a simulation environment having the following properties: 

1. An object oriented approach to developing the mathematical description of devices 

independent of the manner in which the variables are represented. 

2. An organized method for generating system equations for interconnecting device 

models into subsystems and systems. 

3. An algorithm for solving the system equations and variables by identifying smaller 

blocks of equations and variables which can be sequentially solved. The 
algorithm develops the concept of the device structural jacobian matrix and the 
system structural jacobian matrix. 

4. The ability to use a wide range of methods to describe variable waveforms. In 

particular, describing waveforms through vectors of coefficients of polynomial 
series, orthogonal function series, and data series are stressed. 

5. The ability to solve the system of equations by employing either the 
Newton-Raphson Method or Waveform Relaxation. The Newton-Raphson 
method is modified to improve convergence properties through the use of 
continuation methods. 

This chapter is organized into five parts. The first part defines the device which is the 
fundamental building block of the system simulation. The second part shows how to 
interconnect several device models into systems and subsystems. The third part defines the 
waveform as a vector of coefficients to approximate waveforms over time intervals. The 
fourth part details the actual procedure for conducting a simulation. The fifth and final part 
details some finer points which should be considered when constructing models. 
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3.1 Device Description 

A Device Description is an organized manner for describing the characteristics of 
a physical component. This description includes definitions of variables which interface 
with other components in a system, variables called states which allow for information 
storage, and constitutive relations describing the device behavior. 

3.1.1 Interface Variables 

The interface variables are defined as either potential variables or flow 
variables depending on their interaction with the interface variables of other devices 
within a system or subsystem. Systems and subsystems are constructed by grouping 
the interface variables of one or more devices into sets called nodes and applying 
network equations determined by the types of variables attached to the nodes. 

All potential variables attached to a node are equated to a potential value 
associated with the node. Physical quantities which can be classified as potentials include 
voltages, signal levels, rotational speeds, deflections, and pressures. All potentials are 
referenced to 0. All potential variables connected to the same node must be defined with 
respect to the same system wide reference level. In other words, 0 must mean the same 
thing for all of the potentials attached to a given node. 

The sum of all flow variables attached to a node is equated to zero. Physical 
quantities analogous to flow variables include currents, power flows, torques, forces and 
mass flow rates. 

3.1.2 Terminals 

Terminals provide a mechanism for organizing the interface variables of a device. 
In general, there are two types of terminals: Normal Terminals and Information 

Terminals. 

A normal terminal has associated with it a flow variable and a potential variable. 
Its electrical analog is one of the wiring terminals on an electrical device. A mechanical 
analog is the rotating shaft coupling of a gearbox. The equations for exchanging energy 
between devices can be generated through the list of normal terminals connected together 
at a given node. 
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An information terminal has associated with it only a potential variable. The 
potential variable is used to convey knowledge between devices without transferring 
energy. Set points, meter readings, and control signals are all examples of energyless data 
which can be conveyed tlirough information terminals. 

All normal terminals have an associated KCL Group number. A KCL group is the 
smallest subset of a device’s terminals such that the sum of the flow variables within the 
subset is identically zero for at least one of the possible dynamic configurations of the 
device. Normal terminals which can not be associated with a KCL group are given a group 
number of 0. The remaining terminals are assigned the group number of their parent KCL 
group. 

The KCL Group number is used to detect possible reference frame problems within a 
simulation network. A given electrical circuit problem for example, must have at least one 
normal terminal with a 0 group node within a given independent system to ensure the set 
of system KCL equations is not singular. Normally this terminal is associated with a one 
tenninal device with an export potential and import flow which is used to specify the value 
of a given reference node potential. This Reference Frame Check is discussed in greater 
detail in section 3.2.4. 

Some devices may have variable numbers of KCL Groups depending on the 
operating point of the device. A simple model of a two terminal switch for example, 
would have 1 KCL group when the switch is closed (the sum of the currents entering the 
switch is identically zero) and 2 KCL groups when the switch is open (both flow variables 
are identically zero). For the purpose of defining the device, the worst case in terms of 
creating singular systems should be used. In the switch example, each tenninal should 
have their own KCL group number for a total of two KCL groups. 

3.1.3 Variable Direction: Import and Export Variables 

The Interface variables can further be classified by whether they are a resource 
(Import) or product (Export) of the device description. A device description can be 
considered a means for generating export variables based on the values of the import 
variables, states, parameters, continuation parameter, and time. 

An import variable is taken as input by the device description. An import variable 
can be any interface variable associated with either normal or information terminals. To 
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ensure a consistent set of equations when several devices are connected together in a 
system, the total number of import variables associated with normal terminals must equal 
the number of normal terminals 

An export variable is explicitly defined and considered a product of the device 
description. An export variable can be any interface variable associated with either normal 
or information terminals. To ensure a consistent set of equations when several devices are 
connected together in a system, the total number of export variables associated with 
normal terminals must equal the number of normal terminals. 

3.1.4 States 

States are variables whose values are stored for a given time for later use. States 
can be used for example, to store the constant of integration for a dynamic equation. States 
can also be used to store the operating mode for a given device. In general, if the value of 
a given variable depends on the previous value of another variable, that other variable is a 
state. 

3.1.5 Parameters 

Parameters are constants which specify characteristics of the device or in other 
words, customizes a given device description to represent a given physical device. A 
model of a resistor for example, includes a parameter for resistance. This precludes the 
requirement to develop a model for every resistor value. We only need construct a generic 
resistor model instead of a 10K resistor model, a 22K resistor model, etc. 

3.1.6 Constitutive Equations 

The constitutive equations are a consistent set of equations for specifying the 
values of the states and export variables. In general, the number of constitutive equations 
needed is equal to the number of normal terminals plus the number of export variables 
associated with information terminals. The total number of import variables associated 
with normal terminals and the total number of export variables associated with normal 
terminals must independently equal the number of normal terminals. There is no 
constraint on the number of import variables associated with information terminals. 
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3.1.7 Device Jacobian Matrices 

A Device Jacobian Matrix provides the sensitivities (partial derivatives) of the 
export variables with respect to the import variables. This implies there is a given 
ordering of both the import X, and export X E variables: 



*/ = 



\ is 



In. 



X E = 



V EI 



E2 



E3 






J = 



dX EI 


dX E1 


dX EI 


dX E; 


dXjj 


dX l2 


dX I3 


dX /ni 


dx a 




d%E2 




dX n 


dX I2 


dX [3 


dX !ni 


dx E3 


dX^ 


dX^ 




dx„ 


dX l2 


dx, 3 




d^En, 




dX^ 


dXfr' 


dX n 


dX,2 


dX /3 


dX/„ 



- 47 - 



The Device Jacobian Matrix is used to generate a consistent set of import variables 
which simultaneously satisfy the device constitutive equations along with constraints 
imposed by the connections of terminals to nodes. From the device point of view however, 
the Jacobian matrix is merely a product that must be computed. 

Up to this point, we have not discussed the manner in which the variables are 
described. If the variables are represented by real numbers, then each element of the 
Jacobian is also a real number. If instead the variables are represented by vectors, then the 
Jacobian elements will be matrices. 

3.1.8 Device Structural Jacobian Matrix 

The Device Structural Jacobian Matrix describes the properties of the elements 
of the device Jacobian matrix for a given type of variable representation without actually 
providing any values. The following codes can be used to describe the properties of the 
matrix elements of the device Jacobian matrix: 



| Code 


Type of Matrix 


0 


Zero Matrix (all elements are always zero) 


I 


Identity Matrix (always the identity matrix) 


D 


Diagonal Matrix (always a linear main diagonal matrix) 


L 


Linear Matrix (The elements are always constant) 


A 


Nonlinear AC Matrix (see Note 3 . 1 . 8 - 1 ) 


N 


Nonlinear Matrix (The elements may not be constants) 


U 


Unknown (The dependence is unknown (treat as nonlinear)) 



Note 3. 1.8-1: An AC Matrix is one for which the constant component of the export 
variable depends only on the constant component of the import variable. The other 
components of the export variable can not depend on the constant component of the 
import variable but are not restricted in any other way. 

The device structural Jacobian matrix is useful in developing the algorithm for 
generating a consistent set of import variables without having to deal directly with the 
potentially much larger device Jacobian matrices. If an iterative solution scheme is used to 
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develop the consistent set of import variables, the device structural Jacobian matrix 
indicates directly which matrix elements must be recalculated for each iteration. (Only the 
nonlinear and unknown elements have values which change between iterations) 

3.1.9 Continuation Parameter 

A system containing one or more nonlinear devices may be difficult to solve with an 
iterative method. The region of convergence around the solution may be so small as to 
make the probability of success for choosing a starting point for the iterative scheme 
almost zero. One method for enlarging the region of convergence is through the use of a 
continuation parameter which varies from 0 to 1. When the continuation parameter 
has value 1, the export variables are developed using the normal nonlinear constitutive 
equations. When the continuation parameter has value 0 however, the export variables are 
developed using a linear set of constitutive equations. As the continuation parameter 
increases from 0 to 1, the export variables traverse a continuous path from the linear 
solution to the nonlinear solution. One common method for generating such a dependence 
on a continuation parameter a is: 

F(X, a) = aF n (X) + (l-a)F,(X) 

where F„( X) is the nonlinear function for generating the export variables, F/AT) is the 
linear function approximation, and F(X, a) is the function for determining the export 
variables for intermediate values of a. Section 3.4.2 describes in detail continuation 
parameters in relation to the Newton-Raphson method. 

3.1.10 Discontinuity Time Prediction 

If the variables are described as a waveform over a given time interval |7 0 ./,] 
knowledge of the time of discontinuities can prove useful to the algorithm which generates 
the consistent set of import variables. The accuracy of a vector description of a waveform 
often deteriorates greatly if there is a discontinuity during the time interval. Varying t x 
such that it falls on a discontinuity will often improve the accuracy of the waveform 
representation. For this reason, each device has the opportunity to recommend a 
recalculation time for the current interval. Normally, the system would use the minimum 
recommended recalculation time offered by any of the devices to recompute the time 
interval. 
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3.2 Network Description 

A network is composed of a system of devices and subsystems whose terminals 
are interconnected at nodes. The network is a closed system having no tenninals defined 
for any of its nodes. A subsystem is a system having tenninals defined for at least one of 
its nodes and therefore can not be solved independently of other devices or subsystems. 

3.2.1 Nodes 

A node connects together one or more terminals from one or more devices. The 
nodal connections are the means by which devices are combined to fonn systems (both 
networks and subsystems). The nodes provide the association of device import and export 
variables with system variables through nodal equations. Each node is assigned a 
serial number for identifying it from the other nodes. There are two types of Nodes: 
Normal Nodes and Information Nodes. 

3.2.1. 1 Normal Nodes 

A Normal Node has at least one normal terminal attached to it. Information 
terminals can be associated with the node as long as none of the information terminal 
potentials are defined as an export variable. A normal node has associated with it a node 
potential as well as a Kirchhoff Current Law (KCL) equation. The number of normal 
nodes is designated by n n . 

In a subsystem, a normal node can also have associated with it a terminal for 
connecting with other subsystems and devices. This terminal can be either a normal 
terminal having an associated terminal potential and flow' variable or an information 
terminal having only an export potential. ( import and export refer here to the direction 
relative to the defining subsystem which is opposite to the normal definition which is 
relative to the components of the subsystem). The total number of normal node normal 
terminals defined for a subsystem is designated n nm . For any given subystem the number 
of normal node terminal export variables and import variables must both independently 
equal n ntn . The total number of normal node information terminals is designated n nti . 

3.2.1.2 Information Nodes 

An Information Node has only information terminals attached to it. Furthermore, 
one and only one of the terminal potential variables must be an export variable. Only a 
node potential is associated with an information node. Information nodes work in the 
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same manner as hooking up stereo componenents: you can hook up as many inputs 
(import variables) as you want to any given output (export variable), but should never 
hook up two or more outputs together. The number of infonnation nodes is designated by 

n t . 

As an option for subsystems, an information node can have associated with it an 
information terminal for connecting with other subsystems. Since the meanings of import 
and export are once again reversed for this terminal, no other export potentials from other 
devices or subsystems may be attached to the node if the information terminal potential is 
an import variable. If the infonnation terminal potential is an export variable, exactly one 
other export potential from other devices or subsystems may be attached to the node. The 
total number of information node information terminals is designated n m . 

3.2.2 System Variables 

System variables comprise the minimum set of variables from which all of the 
device import and export variables can be derived from. The set of system variables is 
composed of node potentials as well as all device import flow variables and normal node 
normal terminal export flow variables. For a subsystem, the node terminal import 
variables are assumed to be provided by the encompassing system or subsystem and are 
not considered system variables. 

3.2.2.1 Node Potentials 

All of the node potentials of the normal and information nodes are system variables 
which must be solved for. Hence there are a total of n p - n„ + node potentials. 

3.2.2.2 System Flow Variables 

All of the Import Flow Variables of the various devices making up the system as 
well as the export flow variables of the normal node terminals are system variables. The 
number of system flow variables is designated by n f . 

3.2.3 System Equations 

3.2.3.1 Kirchhoff Current Law Equations 

Kirchhoff’s current law states the sum of the flow variables entering a node is equal 
to zero. For a given normal node or normal terminal node, this law is expressed by 
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generating a list of the terminals of the various devices and subsystems attached to the 
node. The number of Kirchhoff Current Law equations is equal to the number of normal 
nodes n„. 



fjO = X /;, = 0 



where 

fjQ KCL Equation for node j (Should Equal Zero) 

it, Number of normal terminals attached to node 

I fi Flow Variable associated with ith normal terminal attached to node j 

3.2.3.2 Potential Difference Equations 

A Potential Difference Equation is created for each of the export potential 
variables of the various devices and other subsystems and for each of the import potential 
variables of the node terminals. This equation merely states the difference between the 
node potential and the potential variable is zero. This equation is expressed by 
generating a list of the terminals of the various devices and subsystems attached to the 
node having an export potential variable. Since one and only one export information 
potential can be assigned to an infonnation node and can never be attached to a normal 
node, the number of potential equations due to export information potentials is simply 
The requirement for a device to have equal number of import and export variables 
associated with normal terminals forces the number of export normal potentials to be ttj. 
Hence the total number of potential equations is n v = /»,• + n } . 

fj i O = V j -V ji = 0 

where 

fjiO Potential Difference Equation for node j export potential variable i 

(Should Equal Zero) 

Vj Node j Potential 

Vjj ith export potential variable associated with node j. 
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3.2.3.3 R nii „ and G 



min 



One method for preventing linear dependences among the system equations is to 
modify the equations to include an extra term corresponding to either a small conductance 
G mln to the ground potential for KCL equations or a small series resistance R m | n for the 
potential difference equations. The KCL equation is now given by: 

/,0 = G 1 ™' / ,+ i / =0 

i = i 



The potential difference equation is similarly modified: 

fa 0 = V j -V jl -R min I ji = 0 

The goal in using G and is to reduce the condition number of the system 
Jacobian matrix to the point where the system can reliably be solved (A singular 
matrix has an infinite condition number). G ^ and can also add fictitious dynamics 
to the system and thereby lead the simulation to produce incorrect results. Hence if used, 
G min and should be large enough to bring the condition number down to a reasonable 
level, but small enough to prevent their inclusion from having appreciable effect on the 
simulation results. 

In general, the use of G TOn and R^n should be avoided for these reasons: 

1. G TO - n and R ^ are fictitious elements. If either is significant, they should be 
explicitly included as a device. 

2. The indiscriminite use of G and R ^ adds to the complexity of the system 
and decreases the degree to which the system can be reduced into smaller blocks. 
In other words the inclusion of G mn and R mn may greatly increase the computation 
time. 

and R mn are included in WAVESIM for these reasons 

1. G^ and R can be selectively specified for individual nodes. If a simulation 
fails to converge for one reason or another, G mn and R ^ can be employed to find 
the part of the system experiencing difficulties. G m „ and R are excellent 
debugging tools. 
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2. Since G ^ effectively connects the node to the ground potential, G mn can be 
used to ensure all of the nodes have the same potential reference and ensure there 
are no linear dependent KCL equations. 
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3.2.4 Reference Frame Testing 



If a given set of a system’s normal nodes can be found such that all terminals 
attached to any of its nodes have nonzero KCL groups and such that if a terminal is 
attached to one of the set’s nodes, then all of remaining terminals of the parent KCL group 
are also attached to one of the nodes of the set, then there exists the possibility of a singular 
system due to the linear dependence of the KCL equations for the set of normal nodes. 

If G TOn is non-zero for a node, it should be considered a terminal with a 0 KCL 
Group. If G^n is zero, it should be ignored. 

Testing for a possible singular system can be accomplished with the following 
algorithm: 

1. Set all the normal node circuit_group_indicators to 0. 

Set the circuit_group_counter to 0 

Set the circuit_group_singular_f lag to 0 

2. Start with the first normal node having a 0 circuit_group_indicator 

If none can be found then algorithm is complete. 

Increment circuit_group_counter. 

3. Change the circuit_group_indicator of the node to the 

circuit_group_counter. 

4. For each terminal attached to the node: 

4a. If the KCL group number is zero, set the 

circuit_group_singular_f lag to 1. 

4b. If the KCL group number is nonzero, loop through each normal 
terminal of the device. If the terminal belongs to the same 
KCL group and the node the terminal is attached to has a 
0 circuit_group_indicator, then set the node 
circuit_group_indicator to the negative 
of the circuit_group_counter. 

5. Search all of the nodes for a negative circuit_group_indicator 

If none can be found and the circuit_group_singular_f lag is zero 
Warn user that a singular system may exist with the group nodes. 

If none can be found then go to step 2 
If one is found, then go to step 3 
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Setting a proper reference for each such set of system nodes can be accomplished by 
attaching to one of the nodes a one terminal device having the following characteristics: 

3.2.4.1 Reference Device 

Interface Variables 

Terminal Potential Variable Flow Variable (KCL Grp) Type 

Ref V (export) / (import) (0) Normal 

Parameters 

V Rc/ Reference Potential Level 

Equations 

v=v Rt/ 

Device Structural Jacobian 

J DS = 10] 



Device Jacobian 



J D = [0] 



Notes 

Most conventional circuit simulations define a reference node for which a potential 
is defined and the KCL equation is not written. Adding this reference device to a node 
effectively converts that node to a reference node in the usual senses. While it is true that 
the KCL equation and an additional Potential Difference equation are still written for this 
reference node, each is part of a one element block. The potential difference equation can 
be solved before the simulation starts since it does not depend on any of the system 
variables. The flow variable on the other hand, only appears in the KCL equation of the 
one node and thus can be solved after all the other system variables have been found. In 
fact, the flow variable should normally equal zero if the rest of the circuit is indeed 
linearly dependent. 

As a convenience to the user, WAVESIM automatically attaches a reference device 
with V rtf = 0 to the node with serial number 0 if that node is used. 
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3.2.5 System Reduction 



The previous sections detail a method for generating a full set of system variables 
and system equations. The total number of system variable equals n si - n„ + n, + tij which 
also equals the number of system equations. For even a small system the algebraic order 
n s j can become quite large. For this reason, elminating system variables and equations 
through system reduction is desirable. The primary tool for performing system reduction 
is the system structural Jacobian. 

3.2.5. 1 System Structural Jacobian 

The System Structural Jacobian facilitates the reduction of the algebraic order 
of the system by showing the nature of the dependence of system equations to each of the 
system variables. The System Structural Jacobian is constructed by combining elements 
of the device structural Jacobian matrices according to the arithmetic of structural 
Jacobian elements. The types of elements in the system structural Jacobian is given by: 



Code 


Type of Matrix [ 


0 


Zero Matrix (all elements are always zero) 


I 


Identity Matrix (always the identity matrix) 


D 


Diagonal Matrix (always a linear main diagonal matrix) 


L 


Linear Matrix (The elements are always constant) 


A 


Nonlinear AC Matrix (see Note 3.2. 5. 1-1) 


1 N 


Nonlinear Matrix (The elements may not be constants) 


! u 


Unknown (The dependence is unknown (treat as nonlinear)) 



Note 3.2. 5. 1-1: An AC Matrix is one for which the constant component of the export 
variable depends only on the constant component of the import variable. The other 
components of the export variable can not depend on the constant component of the 
import variable but are not restricted in any other way. 

The addition and subtraction operators for the structural Jacobian elements is a 
function of the manner in which the system variables are represented. For all of the 
methods used in this thesis, the following definitions apply: 
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I + I = D 
1-1 = 0 
I ±0 = 1 
•I ±0 = D 
-I -I = D 

±n ±m = ±m ±n = n ( ti>m , n^I) 

U >N >A>L>D>I >0 

Note, the Identity Code I, is not strictly necessary and if eliminated simplifies the 
addition and subtraction operators to: 

±n ±m = ±m ±n = n ( n>m ) 

Before the system structural jacobain can be constructed, the system variables and 
equations must be ordered. The first n p variables are the node potentials of the normal 
and information nodes arranged in the order of the node serial numbers. The next tij 
variables are the import flow variables ordered first by device then by device terminal. 

The first n n equations conform to the Kirchhoff Current Law equations for the normal 
nodes arranged in order of the node serial numbers. The remaining n v equations are the 
potential equations for the export potentials ordered first by the node serial number they 
are attached to, then by the order of the devices attached to the node, and finally by the 
order of the terminals in the device. 

The system structural Jacobian is constructed in two parts after being initialized to 
contain only 0. First, a Kirchhoff Current Law equation is generated for each normal 
node. The normal terminals of the normal nodes are examined one at a time. If the flow 
variable is an import variable, it is also a system variable and an / is added to the 
corresponding element of the system Jacobian matrix. If the flow variable is an export 
variable, its corresponding row of the device structural Jacobian matrix is extracted. The 
columns of the device structural matrix row correspond to the device import variables. 
All of the device import variables can be associated to either a node potential (one of the 
first ti p columns of the system structural Jacobian) or to one of the remaining rij import 
flow variable columns. Hence it is quite easy to locate to which column each element of 
the device structural Jacobian row must be added. If G ^ is non-zero for the node, a D 
code is added to the column corresponding to the node potential. 
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The remaining n r rows of the system structural Jacobian matrix are constructed by 
examining each node one at a time. If the node has an export potential associated with it. 
An / is added to the corresponding node potential column and potential equation row 
element (unless of course the node is a reference node and does not have a column 
associated with its potential). The row of the device structural Jacobian matrix 
corresponding to the export potential is then extracted. In exactly the same manner as 
described above for the export flow variables, the columns of the system structural 
Jacobian matrix are correlated to the columns of the device structural Jacobian matrix. 
Once correlated, the elements of the device structural Jacobian row are subtracted from 
the appropriate elements of the system structural Jacobian matrix. If is non-zero for 
the node and the terminal having the export potential has an import flow variable, then a 
D is added to the column corresponding to the import flow flow variable. If R mJn is 
non-zero for the node and the terminal having the export potential has an export flow 
variable, then a D is multiplied by the elements of the corresponding row of the device 
structural Jacobian matrix before being added to the corresponding column in the system 
structural Jacobian matrix. 

Once the structural Jacobian matrix has been constructed it can be examined to 
ensure there are no glaring problems such as a row or column containing only 0 elements. 
If a row or column contains only 0 elements, the system is ill-posed and can not be 
solved. 

3.2.S.2 Blocks 

The primary reason for constructing the system structural Jacobian matrix is to 
break down the system of equations and system variables into smaller blocks which can 
be sequentially solved instead of solving the entire system at once. A block B, is defined 
as n bi system variables and n bi equations which only depend on system variables of the 
present block and previous blocks in the sequence. A block of size is identified by 
finding tt bi rows in the system structural Jacobian matrix that have not already been 
allocated to a block and have exactly n bi columns containing non-0 elements. Of the 
many combinations of blocks which can be found for a system, the best combination 
contains the largest number of small blocks. Here is an algorithm for finding the blocks: 

1. Create a list for each row containing the number of unallocated non-0 entries 
in that row. (Initially all the rows and columns are unallocated) 
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2. Examine the list for rows having only 1 unallocated non-0 entries. Create a 
block for each of these rows and their associated columns. Mark the rows and 
columns as allocated. 

3. Update the list of unallocated non-0 entries in each row. 

4. Continue steps 2 and 3 until no more single rows can be allocated. 

5. Examine the list for two rows only having unallocated non-0 entries in the 
same two columns. Create a block for each pair of rows and their associated 
columns. Mark the rows and columns as allocated. 

6. Update the list of unallocated non-0 entries in each row. 

7. Repeat steps 2-6 until no more single row and double row blocks can be 

identified. 

8. Examine the list for three rows only having unallocated non-0 entries in the 
same three columns. Create a block for each set of three rows and their 
associated columns. Mark the rows and columns as allocated. 

9. Update the list of unallocated non-0 entries in each row. 

10. Repeat steps 2-9 until no more blocks of up to size 3 can be identified. 

11. Continue the above algorithm until all of the rows and columns have been 

allocated. Remember it is necessary to go back and attempt to identify 

smaller sized blocks after discovering a larger block since the removal of a 
column could allow the identification of a new smaller block. 

The order of identifying blocks is very important because they must be solved in the 
same order. Each block contains the same number of system variables and system 
equations. The equations only depend on system variables determined from the present 
and previous blocks. Hence the simulation problem becomes an issue of solving 
sequences of relatively small systems of equations described by blocks. 

3.2.6 Reduced System 

The reduced system consists of the sequence of blocks which when solved, provide 
the solution for all the system variables. Solving each of the blocks can be done a number 
of ways. Most schemes start with an initial guess for the system variables and generate 
corrections to the guesses until all of the system equations for that block are satisfied. 
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Generating the corrections is normally done through the use of a block Jacobian matrix 
which can be constructed in much the same manner as the system structural Jacobian. If 
the block structural Jacobian does not contain any A, N or U elements, the block Jacobian 
can be inverted and multiplied by the system equation errors to provide the required 
corrections. If there are any nonlinearities, this scheme can be performed several times 
until the system equation errors are close to zero. This method is commonly referred to as 
the Newton-Raphson method and if the initial guess is close enough to the solution, the 
method converges quadratically. This method is described in much more detail in section 
3 . 4 . 1 . 

Relaxation techniques can also be used to calculate the system variables. Relaxation 
techniques start with an initial guess for all of the system variables and update each 
variable one at a time by solving a single system equation by assuming all of the other 
variables are constant. Typically, one system equation is assigned the task of solving for a 
particular system variable. With careful thought as to the assignment of variables to 
equations, it is often possible for such a system to converge to a solution. Common 
relaxation techniques are the Gauss-Seidel and Gauss-Jacobi methods. 
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3.3 Waveforms 



Up to this point, the development of the simulation structure has been independent of 
the manner in which variables are actually described. The simplest and most commonly 
used method for representing variables is through a single real number representing the 
value of a variable at a specific time. For static simulations where the problem is to obtain 
the steady state solution for the system, this method works very well. Appendix C and 
Appendix D demonstrate this procedure for the classic load flow problems. For dynamic 
simulations however, some knowledge as to the time history of the variables is needed to 
calculate derivatives and integrals. A dynamic simulation is implemented as a series of 
static simulations where the dynamics are represented by functions of the time increment 
and state variables. The various integration techniques for this type of simulation differ 
only in the interpolation scheme used to approximate the variables between successive static 
simulations. The time increment between static simulations must be carefully controlled to 
ensure the interpolation scheme has enough accuracy for numerical stability. Integration in 
this manner requires careful control of the time increment to ensure the interpolation 
scheme is accurate enough to ensure numerical stability along with an accurate solution. 

Another approach to representing variables is the waveform. This method employs a 
vector of coefficients to continuously describe the time domain value of the variable over 
some time interval [t^ <,]. The type of the waveform determines how the coefficients are 
interpreted to generate the time domain values. Possible types include Data Series, Fourier 
Series, Legendre Series, Polynomial Series and Legendre Series. The principal advantages 
of using waveforms over discrete points include: 

1. Interpolation is not generally required to determine intermediate points. The 
value of a variable can readably be determined for any time. 

2. The numerical stability of Integration and Differentiation techniques do not 
have to depend on the time step control since integration and differentiation 
become waveform operators on an equal level to all other operators. Time step 
control becomes only an issue of numerical accuracy and not of numerical 
stability. 

3. Certain operations may be easier to perform with one waveform type. The 
ability to efficiently convert a waveform from one type to another type and 
back again allows one to use the most efficient waveform type in the 
calculations of a given operator. 
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3.3.1 Waveform Definition 



A waveform approximates the instantaneous value of a variable over some time 
interval. The elements of information contained within a waveform must as a minimum 
include: 

1 . The name of the waveform 

2. The beginning and ending times of the interval (t 0 r,) 

3. An Array of Coefficients representing the waveform (c,) 

4. The number of coefficients in the Coefficient Array ( n ) 

5. A waveform type indicator. 

The waveform type indicator identifies how the coefficients should be 
interpreted when operations are performed on the waveform. Here is an example of a C 
structure defining a Wavefoim: 



typedef struct Waveform 
{ 



char *name; 

double tO; 
double tl; 
void *c; 
long n; 
long type; 
long version; 



/* character string of the name 
of the variable */ 

/* time of the beginning of the interval */ 
/* time of the end of the interval */ 

/* array of coefficients */ 

/* number of elements in the array */ 

/* waveform type indicator */ 

/* Version of this waveform */ 



struct Waveform *next; 
struct Waveform *last; 
struct Jacobian *jnum; 

struct Jacobian *jden; 

} 

WAVEFORM; 



/* pointer for forward 
linked lists */ 

/* pointer for backwards 
linked lists */ 

/* pointer to linked list of 
jacobians where this waveform 
is the numerator */ 

/* pointer to linked list of 
jacobians where this waveform 
is the denominator */ 



The above definition also includes the following optional information: 



6. A Version Number to record a change in the waveform’s properties. 

7. An Address Pointer to the waveform representing the previous time interval. 

8. An Address Pointer to the waveform representing the following time interval. 

9. An Address Pointer to a linked list of Jacobian Structures. 
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The waveform address pointers allow one to construct a linked list of waveforms to 
describe the time history of a variable over a number of time intervals. The Jacobian 
structure as well as the version number will be described in section 3.3.3. 

Note the waveform coefficients are declared to be of type void. This is done to allow 
for the coefficients to be abstract data representations in themselves. Normally the 
waveform coefficients would be double precision floating point numbers, but it should also 
be possible to incorporate other types of data. It may be advantageous for example, to 
represent the coefficients with complex numbers. In this case, each element in the 
coefficient array would be a structure holding double precision floating point numbers 
corresponding to the real and imaginary parts (Or magnitude and phase angle) of the 
complex number. 



- 64 - 



3.3.2 Waveform Operators 

Waveform Operators are functions which act on waveform arguments to generate 
new waveforms, or provide some information about the waveform arguments. The types 
of functions can be broken down into several groups: 

1. Arithmetic Operators 

2. Trigonometric/Exponential Operators 

3. Switching Operators 

4. Integral/Differential Operators 

5. Waveform Content 

6. Special Functions 

3.3.2.1 Arithmetic Operators 

The arithmetic operators are the customary addition, subtraction, multiplication, 
division, and assignment operators usually associated with floating point arithmetic. The 
assignment operator is a bit more complex since it must incorporate waveform type and 
number of coefficient conversions. 

3.3.2.2 Trigonometric/Exponential Operators 

The Trigonometric/Exponential operators include most of the transcendental 
functions used in engineering. Examples include sine, cosine, tangent, logarithms, 
exponentials, as well as the inverse functions. Error handling can become quite complex 
since several of these operators may be undefined at one or more points within the 
argument waveform. These operators are usually handled by convening the arguments to 
a series of data points, performing the operation point by point, and then converting back 
to the appropriate waveform type. 

3.3.2.3 Switching Operators 

Switching Operators are operators producing waveforms which themselves or one 
of their derivatives are discontinuous. Examples include the absolute value function, the 
sign function and the step function. The typical method for calculating these functions is 
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to determine the discontinuity points and use integration to create a characteristic function 
series solution (e.g. Legendre Series or Chebyshev Series) for the result. The series 
solution is then converted to the appropriate waveform type. 

3.3.2.4 Integral/Differential Operators 

One of the key advantages of using waveforms in dynamic simulations is that 
integration and differentiation become very simple operators where the stability of a 
numerical integration scheme is generally not an issue. For many waveform types, the 
integration operator is a linear matrix operation with bounded coefficients. If the 
argument waveform has bounded coefficients, the returned waveform will also be 
bounded. Of course, numerical stability does not assure numerical accuracy. Because the 
integration operator typically generates some truncation error, the returned waveform can 
still contain considerable errors. 

3.3.2.5 Waveform Content 

The significance of the Truncation Error of a waveform can be estimated by 
calculating the waveform content of its higher order term. The waveform content of a 
term is defined as the magnitude of a coefficient divided by the square root of the sum of 
the squares of all the coefficients. Normally, one expects the higher order terms of an 
orthogonal series representation to progressively have smaller and smaller waveform 
contents. Hence if the last few terms have values below a preset threshold, the truncation 
error can normally be assumed negligible. 

Accurate truncation error estimation is still a difficult and currently unsolved 
research topic. The waveform content method is a practical method but should not be 
taken as the last word on the subject. 

3.3.2.6 Special Operators 

Several special operators unique to waveforms should also be developed. One very 
useful operator returns the time of zero crossing of the waveform. Another returns the 
value and time of every local minimum and maximum of a waveform. 

The smoothing operator is one method for reducing the waveform content of 
higher order coefficients. A waveform is smoothed by returning the local average of the 
waveform over some prespecified time increment. Smoothing eliminates discontinuities 
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in a waveform and its derivatives. Since discontinuities tend to amplify the waveform 
content of the higher order terms, removing the discontinuities should reduce the higher 
order term waveform content. 
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3.3.3 Jacobians 



A Jacobian matrix contains the partial derivatives of the coefficients of one 
waveform with respect to another waveform. Here is a sample C structure to define a 
Jacobian: 



typedef struct Jacobian 
{ 

struct Waveform *num; 

struct Waveform *den; 

long version; 
long num_version; 
long de reversion; 
void **j; 



char sj; 



/* address of waveform in the 
numerator of the partial 
derivatives */ 

/* address of waveform in the 
denominator of the partial 
derivatives */ 

/* Version number of the 
jacobian matrix */ 

/* Version nbr of 

numerator Waveform */ 

/* Version nbr of 

denominator Waveform */ 

/* array of jacobian elements 

The first row index is for 
an array of pointers whose 
elements are arrays with 
the colum index */ 

/* Structural Jacobian Code */ 



struct Jacobian *next; /* address for linked list 

of Jacobians */ 

) 

JACOBIAN; 



Jacobians are used in the process of solving simultaneous systems of waveform 
equations through relaxation methods or through the Newton-Raphson Method. The 
purpose of num_version and den_version is to record which versions of the numerator 
and denominator waveforms the jacobian was calculated for. The element version is used 
when several jacobians are combined and it is necessary to determine whether the 
combined matrix must be recalculated. 



In general, all operations defined for a waveform should also generate the jacobian of 
the results with respect to the arguments. Through the use of the chain rule, the jacobian 
matrix of the export variables of a device with respect to the device import variables can be 
determined. 

The structural jacobian code indicates the dependence and structure of the 
jacobian matrix. Here is a list of the codes: 
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Code 


Type of Matrix 


0 


Zero Matrix (all elements are always zero) 


I 


Identity Matrix (always the identity matrix) 


D 


Diagonal Matrix (always a linear main diagonal matrix) 


L 


Linear Matrix (The elements are always constant) 


N 


Nonlinear Matrix (The elements may not be constants) 


U 


Unknown (The dependence is unknown (treat as nonlinear)) 



The structural jacobian code along with the version numbers determines whether or 
not a jacobian matrix needs to be recalcuated. If the structural jacobian is of type 0, I, D, 
or L then the jacobian need not be reconstructed if the there is a version mismatch between 
the waveform version and the jacobian version. If the structural jacobian of type N or U, 
and there is a mismatch between the version numbers of the jacobian and the waveforms, 
then the jacobian elements must be recalculated. After every recalculation, the version 
numbers are updated. In this manner, only jacobian matrices with changing coefficients 
are ever recalculated. 

Technically, the structural jacobian codes depend on the waveform type used. In this 
thesis however, all of the waveform types produce the same structural jacobian codes. 

3.3.3.1 Jacobian Operators 

Several operators for jacobian objects will prove useful in developing a simulation 
environment. These operators include: 

1. Addition and Subtraction 

2. Identity and Zero Jacobian generators 

3. Multiplication by a constant 

4. Multiplication of two jacobians 

5. Multiplication of a jacobian by a waveform 

6. Inverting a jacobian 

If the waveform is described by an array of double precision floating point numbers, 
the Jacobian coefficients can also be defined to be an array of double precision floating 
point numbers. In this case, the above operations employ standard matrix manipulations. 
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3.3.4 Waveform Examples 



While the possibilities of waveform definitions is endless, this thesis will concentrate 
on the following waveform types: 



Waveform Type 


Code 


Undefined 


0 


Data Series 


1 


Fourier Series 


2 


Legendre Series 


3 


Polynomials 


3 


I Matlab Polynomials 


5 


Chebyshev Series 


6 



The code in the above table refers to the value of element type in the WAVEFORM 
structure. Appendix E describes these waveforms and their arithmetic in great detail. 
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3.4 Conducting the Simulation 

Once the physical system has been specified by device descriptions and network 
equations, the solution for all of the system variables can be determined in several ways. 
The method used in this thesis is the Newton-Raphson method with continuation 
parameters. 

3.4.1 Basic Newton-Raphson Algorithm 

The Newton-Raphson method solves a system of nonlinear equations F(x,u) = 0, 
F() € 9T, for the system variables x € 9T with system input variables u e 9Cby first 
linearizing the system of equations about a given guess for the solution x k then solving the 
linear system to produce a new guess x* +7 . This procedure is repeated until F(x k ,u) = 0 is 
satisfied within a given tolerance. The sequence of points x k starting with k = 0 is called 
the solution trajectory for at 0 . A converging solution trajectory eventually converges to a 
solution while a diverging solution trajectory does not. 

F(x,u) is linearized by taking the Taylor series expansion about the point x k : 

F(x,u) = F(x k , u ) + J(x k , u )a a + O (x • x) = 0 
x = x k +x A 



where the Jacobian matrix J(x^u) is defined by: 



J(x°,u) 



BF(x°,u) 

Bx 



Assuming the error 0(x’x) is negligible and the Jacobian can be inverted, the 
correction x A for a given guess x k is given by the linear approximation: 

x A = -J~\x k ,u)x k 

The correction is applied to x k to produce x* +I , the value of x for the next iteration: 

x =x +x A 

Around each solution of F(x,u ) = 0 for which the Newton-Raphson method reliably 
converges, a region exists such that if a trajectory enters that region, it will never leave and 
eventually converge to the solution. The size of this local convergence region depends on 
the nonlinearity of the system. For purely linear systems, this region encompasses the 
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entire cr" space. If the intitial guess falls within the local convergence region, the 
Newton-Raphson method will by definition converge. If the initial guess falls outside the 
local convergence region, one of several things can happen. First, the solution trajectory 
could enter the local convergence region of a solution and converge on a solution. Second, 
the Newton-Raphson method could fail due to a singular Jacobian. Third, the trajectory 
could diverge and tend to infinity. Fourth, the trajectory could become cyclic where 
x = x k for k sufficiently large enough. Finally, the trajectory could enter a chaotic region 
in which there is no solution but from which the trajectory never leaves and is not cyclic. 

As an example, define F(x,u) to be the following lxl system: 

F( x,u) = x 3 -x 
Figure 3.4.1-1: F(x,u) = x 3 -x 




The Jacobian matrix is: 



/ = [ 3x 2 -l] 



The recursion fonnula for x k+I is given by: 



x t + 1 =x k 



(x k ) 3 -x k 

- V ) 2 - 1 
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There are three solutions for this system and their local convergence regions are 
given by: 



Root 


Local Convergence Region i 


*i = -l 


—VF 


x 2 = 0 


-VF^VF 


x 3 = +1 


VF*”*” 



In two other regions, the solution trajectory jumps to one of the local convergence 
regions after one iteration: 



Root 


Convergence Region 


*i = -l 


0.46560 < x° < 0.57735 I 


* 3 = +1 


-'yJ ^ = -0.57735 < x° < -0.46560 



In two other regions, the solution trajectory may jump to one of the local 
convergence regions after several iterations or fail to converge: 



Variable Behavior Region 



VF° 



44721 <x°< 0.46560 



-0.46560 < a: 






44721 



On the boundaries for the above regions, the Newton-Raphson method fails: 
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> 


Failure Mode 


i *vr 


Singular Jacobian 


±0.46560 


Singular Jacobian 


*VT 


Cyclic Trajectory 



In the above analysis, no constraints were made in the speed of convergence or on 
the size of x. If | x k |» 1 the speed of convergence will be very slow since x t + l = j x k and 
the number of iterations / required will be about: 



log(U* |) 
log(1.5) 



5.681og(| x k |) 



Furthermore, most machines have a limit as to the largest number which can be 
represented. If an iteration causes x to exceed this number in magnitude, a floating point 
overflow error will typically be generated. This phenomena is known as Newton Overflow 
and has the effect of reducing the size of the convergence regions. For example, if x is 
known to be bounded by the interval [-10 10], then x° should be restricted to the following 
regions: 



Root 


Convergence Region 


= 1 


-10 <A°< -0.58904 
0.46560 < *° <0.56675 


x 2 = 0 


-0.44721 < jc° < a/| = 0.44721 


x 3 = +1 


-0.56675 < Jt° < -0.46560 
0.58904 <a°< 10.0 
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3.4.2 Continuation Methods with Newton-Raphson 

The previous discussion indicates the need for careful selection of the initial guess x°. 
The use of a continuation parameter in so called homotopy methods is one of the many 
ways for attempting to generate x° within the convergence region of the desired solution. 
In general, a function f/(jc,«,a) = 0 is generated such that //(*,«, 1) = F(x,u) and 
/f(x,u,0) = G(x,u) where G{x,u) is a linear function in x. One common method of creating 
H(xyUyO) is: 

H(x,u, a) = <xF(x,u) + (l -a )G(x,u) 

The problem now is to develop the linear function G(x,u). There are several 
approaches which can be taken for each row G,(x,«): 

1. Linearize about a known operating point. This is equivelent to providing an 
initial guess for each of the variables and using the Newton-Raphson method 
directly. 

2. Use a least squares fit of a linear system over a known operating region of 

F,{x,u). 

3. Select G,{x,u) such that the solution for H(x,u, 0) = 0 is most likely to be within 
the convergence region of F(x,«). 

Once H(x,u, a) has been constructed, it can be used in several ways: 

1. Start with oc=0 and obtain a solution to the linear system, then progressively 
increment alpha by small amounts and solve the nonlinear system until a=l. The 
rational is to employ the unbounded local region of convergence of the linear system 
to move the initial guess into the local region of convergence for the next nonlinear 
system formed by incrementing a. As a is incremented, the solution for the previous 
value of a is assumed to be within the local region of convergence for the present 
value of alpha. Appendix B demonstrates this may not always happen due to 
bifurcations of solutions as a is incremented. 

2. Start with oc=l and attempt to obtain a solution to the nonlinear solution. If the 
trajectory has not converged after n ^ iterations, decrement a and attempt to find a 
solution. Progressively decrement a until a solution is obtained, then increment a 
using the solution of the previous value for a for the initial guess. This procedure 
assumes the local convergence region for a given solution will increase as a is 
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decremented. Eventually the local convergence region should grow large enough to 
encompass even a poor guess for the solution. This procedure has the advantage over 
the previous method in that it may avoid bifurcations which occur between 0 and the 
minimum value for a used. However, the number of iterations for a may be larger. 

Note that the value for n ^ as well as the convergence criteria may be a function of 
a. There is no reason to obtain a highly accurate solution for intermediate values of a 
since the only purpose is to move the initial guess for the next a iteration into the new 
local region of convergence. Only when a=l should the convergence criteria be enforced 
for obtaining a highly accurate solution. 
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3.4.3 Simulation Algorithm 

The simulation algorithm employed by WAVESEM is conducted totally within the 
MATLAB environment and is composed of four parts. The first pan initializes all of the 
simulation parameters. The second part performs the time increment control and has 
embedded with in it the third part which is the sequential solving of each of the blocks. 
The final part is composed mostly of plotting and storing the results of the simulation. 

Figure 3.4.3-1: Simulation Flowchart 
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3.4.3.1 System Initialization 



A number of parameters and arrays need initialization before the simulation can 
commence. These parameters and arrays are: 

n Initial number of wavefonn coefficients 



N 


Actual number of waveform coefficients used 


vftype 


Waveform type indicator 


to 

tl 


Beginning time of simulation 
Ending time of simulation 


sb n min 
sb n max 


Minimum number of coefficients to use 
Maximum number of coefficients to use 


sb_n__data 


Number of points per waveform for plots 


sb dt init 
sb dt optimum 


Initial time increment 
Optimum time increment 


sb dt min 
sb dt max 


Minimum time increment 
Maximum time increment 



sb_dt_ave Minimum time of interest (Averaging interval) 

Break Points are user specified times for which waveform interval boundaries are 
forced to occur. Break Points are completely optional and their inclusion is up to the 



system modeler. 




sb__bp 

sb_bp_nbr 


Array of Break Points 
Number of break points 


sys node serial 
sys node name 


Array of Node Serial Numbers 
Array of Node Names 


sb_alpha_init 


Initial Value of continuation parameter alpha for nonlinear 
blocks 


sb dalpha_init 


Initial Value of alpha increment 


sb dalpha min 
sb dalpha max 


Minimum alpha increment 
Maximum alpha increment 


sys Gmin 
sys Rmin 


Array of Gmin values for all of the nodes 
Array of Rmin values for all of the nodes 



The index for sys_Gmin and sys_Rmin are the node numbers of the nodes they 
apply to. 
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sb check, eqn err 


= 0 for don’t check equation error 
= 1 for checking equation error 


sb check_var_err 


= 0 for don’t check max variable correction 
= 1 for checking max variable correction 


sys kcl err 
sysjpot err 


Array of maximum KCL errors for all nodes 
Array of maximum Potential Differences for all nodes 


sys nd err 
sys fv err 


Array of max corrections to Node Potentials for all nodes 
Array of max corrections to Flow Variables for all nodes 


sb i kcl err 


Multiplier for maximum KCL error 
for alpha less than 1 


sb L_pot err 


Multiplier for maximum Potential Difference 
for alpha less than 1 


sb i nd err 


Multiplier for max correction to node potential 
for alpha less than 1 


sb i fv err 


Multiplier for max correction to flow variable 



for alpha less than 1 

The index for the above eight arrays are the node numbers of the nodes they apply 



to. 




sb maxcnt 
sb i maxcnt 


Maximum number of iterations for alpha = 1 
Maximum number of iterations for alpha < 1 


sb_div_st a rt_cnt 


Number of iterations to skip before checking 
for divergence 


sb div_max_cnt 


Maximum number of diverging iterations before 
assume system is diverging 


sb i div err 


Multiplier of errors for ignoring diverging check 


sb max wc 
sb nbr wc 
sb mult wc 


Maximum waveform content of a waveform 
Number of coefficients to apply waveform content to 
Multiplier to sb_max_wc for decrementing N 


sysjpot_scale 
sys flow scale 


Array of Scaling factors for node potentials 
Array of Scaling factors for flows attached to nodes 



The index for sys_pot_scale and sys_flow_scaie are the node numbers of the 



nodes they apply to. 




dev_par name 
dev sO name 


Device parameter arrays: name is the device name 
Device state initial value array: 
name is the device name 
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ivar nd nbr 


Initial guesses for node potentials: 
nbr is the node serial number 


ivart nd nbr 


Waveform type for initial guess 

nbr is the node serial number 


ivar fv mune 


Initial guess for flow variables: 
name is the variable name 


ivart fv name 


Waveform type for initial guess 
name is the variable name 


his_t 


Matrix of time increment end points 
First row is beginning of intervals 
Second row is end of intervals 
Columns are waveform interval index 


his_N 


Vector of number of coefficients in waveforms for each 
waveform interval 


his col 


The waveform interval index. After simulation this equals 
the number of columns in history arrays 


his nd nbr 


Matrix of Node Potential waveforms. Each column 
corresponds to the waveform for the node potential over a 
given waveform interval, nbr is the node serial number 


his_fv_najne 


Matrix of Import Row Variable waveforms. Each column 
corresponds to the waveform for the import flow variable 
over a given waveform interval, name is the variable name 


his s name 


Matrix of Device name state values. The first column 
corresponds to the initial state values with subsequent 
columns corresponding to the state values at the end of 
waveform intervals. Note this matrix has 1 more column 
than all the other history arrays. 


blk nbr nrow 


Number of rows in block nbr 


blk nbr ncol 


Number of columns in block nbr 


blk nbr row sys 
blk nbr col sys 


Cross Reference of Block nbr rows to System Rows 
Cross Reference of Block nbr columns to System Columns 



blk_nbr_linear_£lag = 0 if block nbr is nonlinear 

= 1 if block nbr is linear 
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Time Increment Initialization 



ddt 


Actual time increment 


ttO 


Beginning of current waveform interval 


ttl 


End of current waveform interval 



ddt, ttO, and ttl are initialized according to the following equations 



cnt tot 


ddt = sb_dt_init 
ttO = to 

ttl = minimum of: 
tO + ddt 
tl 

sb_bp (1) 

Set to zero: Total number of Jacobian inverses 


his flops 


Number of floating point operations used 



-81 - 



3.4.3.2 Time Loop 



Truncation Error Control 

The simulation time interval between to and tl may be divided into a number of 
waveform intervals to improve the truncation error of the system variable waveforms. In 
general, truncation error can be reduced by either increasing n or by decreasing the 
waveform interval ttl - tto. Within WAVESEM, the general strategy' for dealing with 
too large of a truncation error is to increase the number of coefficients n if the waveform 
interval is less than sb_dt_optimum and shorten the waveform time interval if greater 
than sb_dt_optimum. In general, the strategy is to minimimize n while maximizing the 
waveform interval subject to the constraint that the truncation error is within tolerances. 
Finding the optimum combination of waveform intervals and number of coefficients is 
not obvious and much work remains for developing better algorithms. 

3.4.3.2.1 Time Loop iteration initialization 

The simulation time loop continues as long as ttO < tl. The beginning of each 
iteration begins with the definition of the following arrays: 

tt = [ttO ttl sb_dt_ave] 
ii = Identity Matrix of size n 
zz = Zero Matrix of size nxn 

Variable Initial Guesses 

Next, initial guesses are provided for all system variables (var_nd_nbr and 
var_fv_name) by converting the waveforms ivar_nd_nbr of type ivart_nd_nbr and 
waveforms ivar_fv_name of type ivart_fv_name into waveforms of type vrtype and 
size n. 

In the present incarnation of WAVESIM, the same waveform is used as the initial 
guess for all waveform time intervals regardless of the values for ttO and ttl. 
Normally, a constant value is specified. A better method would allow the user to specify 
an actual guess as to the waveform history as a function of time. The time loop iteration 
initialization would then have the responsibility of converting the waveform data as 
provided by the user into a waveform of type vrtype and size n over the interval between 
tto and ttl. Providing an initial guess for the waveform history of all the variables 
would allow for example, a linear model of a system be run first to generate the initial 
guess for a nonlinear model of the same system. Convergence of the nonlinear system 
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should be greatly accelerated for many systems. Parameter sensitivity studies would 
also be greatly accelerated if the parameter variations are not expected to cause major 
changes in system performance. 

Failure Flags 

Two final variables, converge_failure and fatai_error are initialized to zero. 
converge_f allure is set to one by a block if convergence failed for that block or if one 
of the block waveforms has too large of a harmonic content. Convergence could fail if 
the number of iterations exceeded the maximum allowed and the alpha increment is 
smaller than the minimum allowed. converge_failure is used to indicate the following 
blocks should not be solved because previous blocks could not be solved. fatai_error 
is set to one if convergence cannot be obtained even when n is equal to or greater than 
the maximum value sb_n_max and the time increment is equal to or smaller than the 
minimum value sb dt min. If fatal error is set, the simulation fails. 
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3.43.2.2 Solving the Blocks 



The blocks are solved sequentially in the order of their detection in the system 
reduction procedure. If converge_faiiure is nonzero, a previous block could not be 
solved for the given time increment and number of coefficients. For this reason, a block 
is not solved if converge_failure is nonzero. 



Figure 3.4.3-2: Solving the Block 




3.4.3.2.2.1 Block Initialization 

Each block requires the initialization of several arrays and variables before the 
block can be solved: 
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blk nbr max eqnerr 
blk nbr max varcor 


Array of maximum errors for the block equations 
Array of maximum variable corrections for the block 
variables 


blk nbr imax eqnerr 


Array of multipliers to blk_/ibr_max_eqnerr for 
alpha < 1 


blk nbr imax varcor 


Array of multipliers to blk nbr_max_varcor for 
alpha < 1 


blk_nbr_cnt 
blk nbr cnt div 


Number of iterations (initialized to 0) 

Number of diverging iterations (initialized to 0) 


blk nbr alpha 


Block continuation parameter. 

= 1 if linear block 

= sb_aipha_init if nonlinear block 


blk nbr dalpha 


Block continuation parameter increment 
= sb_dalpha_init 


good alpha 


Last value of alpha for which block converged. 
Initialized to -1 


good var_nd_nbr 


Last value of node nbr potential for which block 
converged. Initialized to var_nd_nbr 


good var fv name 


Last value of import flow name for which block 
converged. Initialized to var_fv_name 


blk_nbr_trec 


Recommended recalculation time for block 
Initialized to tti 


blk_nbr_ivc 


Array of indexes in block variable array for which the 
variable correction was greater than allowed. 
Initialized to an empty array. 


div cnt 


Number of diverging iterations, set to 0 


div err 


Maximum relative error of previous iteration 
Initially set to 0. 
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3.43.2.2.2 Continuation Parameter Loop 

The block continuation parameter loop continues as long as bik_nbr_aipha < 1. 
Within this loop, the following procedures occur: 

1. Import Variables for all associated devices specified 

2. Device Objects called to generate 

A. Export Variables 

B. Device Jacobian Matrix 

C. State values at time tti 

D. Recommended recalculation time 

3. Block recalculation time calculated 

4. KCL and Potential Difference Equation Errors calculated 

5. Errors Scaled and compared to maximum limits 

if good, solution saved and bik_nbr_alpha incremented 
as necessary. 

6. Iterations counted and compared to maximum limit 

bik_nbr_aipha decremented and variables reset 
as necessary. 

7. Block Jacobian Matrix assembled and scaled 

8. Variable Corrections Calculated 

9. System variables corrected 

3.4.3.2.2.2.1 Device Import Variable specification 

The matrix dev_i_name is generated for each device name where the columns 
are the waveform coefficients for each of the device import variables. Each column of 
the dev_i_name matrix is one of the system variables, hence all are available. 

3.43.2.2.2.2 Call Device Objects 



Each of the device objects associated with the block is provided with the 
following information: 

wtype Waveform type 

dev_i_name Device name import variable matrix 
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dev_jpar_najne Device name parameter array 

dev_sO_name Device name state initial value ttO array 

tt Time structure 

blk_n±>r_alpha Block nbr Continuation Parameter 

From this infonnation, each of the device objects generates the following 

dev_e_name Device name export variable matrix 

dev_j_name Device name jacobian matrix 

dev_sl_name Device name state final value ttl array 

dev_tr_name Device name recommended recalculation structure 

= [ntl ntt] where 

ntl = recommended ttl for present interval 
or set to ttl if no recommendation 
ntt = recommended ttl for next interval 

or set to ttO if no recommendation 

3.43.2.2.2.3 Recommended Recalculation Time 

The block recommended recalculation time blk_nbr_trec is set to the 
minimum value of all the ntl values from all of the devices associated with the block. 
If convergence fails blk_nbr_trec is used to generate a new value for ttl. 

Similarly, bik_nbr_ntrec is set to the minimum value of all the ntt values 
greater than ttl from all of the devices associated with the block. For a successful 
convergence, blk_nbr_ntrec is used to help generate a new value for ttl for the 
next waveform interval. 

3.43.2.2.2.4 Equation Errors 

For each of the node nd KCL equations associated with block nbr, an error 
variable blk_n±>r_kcl_nd is generated by adding the flow variables of the attached 
terminals to the flow through Gmin. Likewise, for each of the export potential name 
Potential Difference equations associated with block nbr, an error variable 
blk_nbr_jpot_name is generated by subtracting from the node potential waveform, the 
waveform of the export potential as well as the contribution from Rmin 

blk nbr kcl nd = E d ev_e_name ( : , col) + E var__fv_vnajne + 

var nd nd X Gmin 
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where 



blk_nbr_pot_vname = var_nd nd - dev e name col) 
dev_x_najae ( : , col) x Rmin 



nd 



nbr 



Block Number 
Node Serial Number 



name 



vname 



Device name 
Variable name 



X 



( : , col) 



The appropriate column from the matrix 

Either e or i depending on associated flow variable 



being an export or import variable 



The KCL equation errors are multiplied by the appropriate flow variable scaling factor 
from the sys_flow_scaie array while the Potential Difference equation errors are 
multiplied by the appropriate potential scaling factor from the sys_pot_scale array. 
Once scaled, the error vectors are assembled into a block error vector bik nbr err. 



If blk_nbr_alpha > l then bik_nbr_ier is filled with the indexes of the rows 
of blk_ni>r_err which are greater in magnitude than the corresponding rows of 
blk_nbr_max_eqnerr. In the same manner, blk_nbr_rel_err is set equal to the 
absolute value of b 1 k_nbr_e r r divided by blk_nb.r_max_eqnerr. 

If blk_nbr_alpha < l then blk_nbr_ier is filled with the indexes of the rows 
of blk_nbr_err which are greater in magnitude than the corresponding rows of 
blk_nbr_imax_eqnerr. Similarly, blk_nbr_rel_err is Set equal to the absolute 
value of b 1 k_nbr_e r r divided by blk_ribr_irttax_eqne:rr. 



On the first iteration for a given value bik_nbr_aipha, div_ C nt is initialized to 
0. For the first sb_div_start_cnt - l iterations, div_err is set to the maximum 
value of blk_nbr_rel_err. On subsequent iterations, if the maximum value of 
blk_nbr_rel_err is smaller than div_err then div_cnt is reset to 0, otherwise 
div_cnt is incremented. In any case div_err is set to the maximum value of 
blk nbr rel err. If div_cnt > sb_div_max_cnt then the algorithm assumes the 



3.4.3.2.2.2.S Error Criteria Check 



Applying Error Criteria 



Divergence Check 
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block is diverging for the given value of blk_nbr_alpha. The failure to converge 
condition is indicated by setting bik_nb.r_cnt = maxcnt: either sb_i_maxcnt if 
blk_nbx-_alpha < 1 or sbjnaxcnt if blk_nbr_alpha > 1. 

Block Convergence Success 

If blk_nbr_ier is the empty set or sb_check_eqn_err is 0, and 

blk_nbr_alpha > 1 and bik_nbx-_ivc is the empty set, then the block solving 
algorithm has been completed and the continuation parameter loop is broken. The 
algorithm proceeds to checking the truncation error for the system variables associated 
with the block. 

Increment Continuation Parameter 

If blk_nbr-_ier is the empty Set or sb_check_eqn_err is 0, and 

bik_nb.r_alpha < l and blk_nbr_ivc is the empty set, then it is time to increment 
the continuation parameter bik_nbx-_aipha. First however, the current value of all 
the variables associated with the block are copied into good_var_nd_nd or 
good_var_fv_name. blk_nbjr_alpha is copied into good_alpha. The variables and 
continuation parameter must be saved because it may be necessary to restore the 
variables if the block fails to converge with the next continuation parameter value. 
blk_nbr_aipha is then set equal to the minimum of 1 and 
blk_nbr_aipha + blk_nbx_daipha and the continuation parameter loop is repeated. 

Iteration Count: Decrement Continuation Parameter 

If the error is still too large, corrections to the system variables associated with 
the block must be generated. But first, the number of iterations blk_n±>x_cnt must be 
incremented and compared to the maximum allowed maxcnt: either sb_i_maxcnt if 
blk_nbr_alpha < 1 or sb_maxcnt if blk_nbr_alpha > 1 . If the limit has been 
exceeded, and one of the devices has recommended a value for bik_nbr-_trec less 
than ttl, then converge_faiiure is set to 1 and attempts to solve the block cease. If 
the limit has been exceeded and bik_nbr_trec equals ttl, the block is recalculated 
with a decremented blk_nbx_aipha which is set to the maximum of: 

(blk_nbr_alpha + good_alpha) / 2 
blkabr alpha - blk_nbr_dalpha 
0 
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If blk_ni>r_alpha has been decremented, the system variables associated with 
the block must be reset to the values stored in either good_var_nd_nd or 
good_var_fv_name. 

Block Convergence Failure 

If blk_nbr_alpha - good_alpha < sb_dalpha_min then the block has failed 
to converge and nothing more can be done on the block level. The variable tree is 
set equal to blk_/ibr_trec and the converge_£ailure flag is set to 1. This is a 
signal to the system to not solve any more blocks and either adjust the value of ttl or 
adjust the number of coefficients n before trying to solve the system again. 

3.4.3.2.2.2.6 Assemble Jacobian 

Jacobian Construction 

If the error is too large, but the maximum number of iterations maxent has not 
been exceeded, the block jacobian matrix must be calculated. The block jacobian 
matrix blk_nbr_j is constructed in the same manner as the system structural jacobian 
was previously constructed with the exception that now the variables and equations 
are only those which are part of the block and the matrix elements are submatrices 
instead of structural jacobian codes. 

Jacobian Scaling 

Once the block jacobian has been assembled, it is scaled by dividing each of the 
columns by the appropriate element of either the sys_flow_scale (if the column 
corresponds to an import flow variable) or sys_pot_scaie (if the column corresponds 
to a node potential) vectors. Likewise, rows of the block jacobian are multiplied by 
the appropriate element of either the sys_flow_scale (if the row corresponds to a 
KCL equation) or sys_pot_scale (if the row corresponds to a Potential Difference 
equation) vectors. Scaling is performed to normalize all of the variables and 
hopefully improve the accuracy of the numerical computations required for solving 
the variable corrections. 

Correction Vector Calculation 

The variable correction vector bik_*ibr_dlta is generated by solving the matrix 
equation: 
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blk_ixbr_j blk_nbr_dlta = blk_nb.r_err 

The most direct method (and one of the least numerically efficient method) of 
calculating blk_nb.r_dlta is to invert blk_nbr_j and multiply by blk_nbr_err. 
Relaxation methods and Gaussian elimination with back substitution are other means 
to the same end. 

Singular Jacobian 

If blk_nbr_j is singular, blk_nbr_dlta can not be calculated and in the present 
incarnation of WAVESIM, the simulation fails. Future versions should include an 
algorithm for attempting to recover from the singular jacobian. 

3.43.2.2.2.7 Correct Variables 

Each of the system variables associated with the block are corrected by 
subtracting the appropriate rows of blk_nbr_dlta divided by the corresponding 
element of the scaling factor vectors (sys_pot_scale or sys_f low_scale). 

3.43.2.2.2.8 Variable Correction Criteria 

If the block is nonlinear (blk_nbr_linear_flag = 0) and the variable 

correction flag is set (sb_check_var_err = l) then bik_nbx_ivc contains the 
indexes of blk_nbr_dlta which exceed in magnitude blk_nbr_imax_varcor if 
blk ni>.r_alpha <1 or blk_nbr_max_varcor if blk_n£>.r_alpha > 1 . If 
blk_nbr_ivc is not empty, then one of the variable corrections was too large and 
another iteration is necessary. In any case, the continuation parameter loop is 
repeated. 
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3.43.2.2.3 Truncation Error Control 

Once a block has been solved, a truncation error check must be performed on 
each of the associated system variables. The truncation error is assumed negligible if 
the waveform content of the last sb_nbr_wc coefficients of each waveform is less than 
the limit specifed by sb_max_wc. If all the system variables have negligible truncation 
error, block nbr has been solved and the next block is processed. If the truncation error 
of any of the variables is too large, converge_faiiure is set to 1 to indicate the block 
has not been solved. 

3.4.3.23 Time Step Control: Successful Convergence 

If all the blocks successfully obtained a solution then the variable 
converge_faiiure will equal 0. The task now is to save all of the variables in the 
history arrays, update tto and tti, update n, and update the device states. 

Update History Variables 

The history variables are extended by one column. The variable his_coi is 
Incremented and is the column index for all but the state arrays. In particular: 

his_t (1, his_col) = ttO 
his_t (2, his_col) = ttl 

his_N (1, his_col) = N 

his_nd_zxbr (1 : N, his_col) = var_nd_nbr 
his_fv_name (1 : N, his_col) = var_fv_name 

his_s_najne ( : , his_col+l) = dev_sl_name 
de v__s 0_najne = dev_sl_na/ne 

where (l : n, his_col) refers to the first n rows of column his_col and ( : , his_col+i) 
refers to all the rows of column his_col + l. 

Update Time Interval and Number of Coefficients 

The time interval is updated by: 

tto = ttl 

If tto >tl then the simulation has successfully completed and the time loop is 
exited. Otherwise must update ttl as well. Initially: 

ttl = ttl + ddt 
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Next, check if a break point (element of sb_bp) exists between tto and ttl. If 
such a break point exists, set ttl equal to the earliest break point after ttO. 

Since reducing n is normally beneficial, if ttl - tto > sb_dt_optimum and 
n > sb_N_min the algorithm assumes the waveforms are well behaved and 
decrementing n (as long as n > sb_n_min) is appropriate. 

Since the series converged for the previous time increment, setting ddt equal to the 
minimum of 2xddt and sb_dt_max allows the system to increase the next time interval 

Plot Intermediate Results 

Before proceeding to solve the system over the updated time interval, WAVESIM 
creates a plot of the system variables over the previous time interval. 
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3.43.2.4 Time Step Control: Unsuccessful Convergence 

Fatal Error 

If one of the blocks failed to converge, ttl - tt2 < sb_dt_min, and 
n > sb_n_majc then the simulation has failed completely and can not proceed further. In 
this case, the simulation comes to a halt prematurely. 

Recommended Recalculation Time 

If one of the blocks failed to converge and tree < tti,then ttl = tree and the 
time loop is repeated. 

Time Increment / Number of Coefficient Control 

If one of the blocks failed to converge and tree > ttl, 
ttl - ttO < sb_dt_opt imum and n < sb_n_max, n is incremented in an attempt to 
improve convergence. To improve convergence if ttl - ttO > sb_dt_optimum or 
n > sb_n_max, the time interval is halved by setting ttl = (ttl + tt0)/2.0. 
Halving ddt is also prudent as long as ddt > sb_dt_min. Once ddt and n have been 
updated, the time loop is continued. 

3.4.33 Simulation Wrap-up 

Once the simulation has completed, the variables stored in the history arrays are 
plotted and saved as the user desires. If the operator desires, the device state variables 
can be used as the initial conditions for a following simulation or saved in file for future 
simulations. 
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3.5 Device Modelling Techniques 

The previous sections described the method WAVESIM uses to generate a 
mathematical system of equations and variables for interconnecting a number of different 
devices. Up to now a device has been treated as a black box characterized by its definition, 
initialization, variables which must be provided to it as resources and variables which are 
generated by it as products. As a review, here are properties of the black box : 

Definition (device . def ) 



Name of Device Type 

Number of Parameters 
Names of Parameters 
Default Values of Parameters 

Number of States 
Names of States 

Default Values of State Initial Conditions 

Number of terminals 
Terminal Definitions 
Terminal Name 

Terminal Type (normal or information) 

Flow Variable Type (import or export) 

Potential Variable Type (import or export) 

Tenninal KCL Group Number 

Device Structural Jacobian 

Initialization (WAVESIM input file) 



Name of Device 

Name of defining Device Type 

Parameter Values 

State Initial Conditions 

Assignment of terminals to nodes 
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Resources (Arguments of MATLAB device. m file) 

Waveform type 

Import Variable Waveforms 

Parameter Values 

Value of states at beginning of time interval 
Time Structure 

Beginning time of Interval 
Ending time of interval 
Minimum time interval of interest 
Continuation Parameter 

Products (Products of MATLAB device. m file) 

Export Variable Waveforms 
Device Jacobian Matrix 
Value of states at end of time interval 
Recommended Time Structure 

Recommended Recalculation Time this interval 
Recommended ending time of next interval. 

While these specifications are the hard requirements for developing a new device type, 
they are not very constraining and it is possible to generate very inefficient and unworkable 
devices. The following sections are meant as guidance for developing new device types. 
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3.5.1 Import and Export Variable definitions 

One of the first tasks in designing a new object is determining which variables should 
be import variables and which should be export variables. The requirement is simply that 
the total number of export variables associated with normal terminals must equal the total 
number of import variables associated with normal terminals. To minimize the number of 
system equations however, one should usually try to define flow variables as export 
variables and potential variables as import variables. 

The constitutive equations defining a device may preclude defining all the flow 
variables as export variables. An ideal voltage source of magnitude V s for example, has 
the following constitutive equations: 

= v 2 + v s 

/l = ./ 2 

Clearly, this set of equations can not be reorganized to specify both currents (flows) 
explicitly. In this case potential V 1 and flow I 2 are export variables and potential V 2 and 
flow / 2 are import variables. 
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3.5.2 Interface Variable Units 



When developing devices, a consistent convention for interface variable units is 
required. Flows are usually referenced such that positive flow into a terminal with a 
positive potential refers to power dissipated by the device. This definition is clear if the 
flow corresponds to currents or forces, but is less clear for torques. For rotating shafts 
where torques are the flow variable and rotational speed the potential, the positive 
direction for speed is in the normal operating direction while the direction for torque is 
determined by the power dissipation rule. A motor connected to a propeller would 
normally have associated a positive rotational speed and a negative torque. The propeller 
would have a positive rotational speed and a positive torque associated with its interaction 
with the motor along with a positive forward speed and negative force associated with its 
interaction with the ship dynamics. The ship dynamics model would have an associated 
positive force and positive forward speed. 

Many power system simulations go through great effort to normalize all variables by 
dividing by device base quantities to improve numerical accuracy. The models are all 
expressed in a Per Unit (PU) basis where the base quantities are machine ratings. The 
problems occur when several devices with different base quantities are combined. The 
system variables must all be scaled appropriately to ensure the elements of the system 
equations are all in the same units. Keeping the bases consistent requires much effort and 
is veiy prone to error. 

In WAVESIM, physical quantities using the metric system (SI) are recommended for 
all interface variables. Strict use of the metric system ensures the proper quantities are 
added and subtracted on the systems level. Individual devices may then scale the interface 
variables by their own base quantites for internal calculations. Likewise, each node of the 
system can have a scaling factor assigned to it for both flow and potential variables. In this 
manner, the beneficial aspects of the per unit system can be retained with little confusion 
as to ensuring consistent base quantities. 
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Metric System (SI) 



Length 


meters 


Time 


seconds 


Mass 


kilograms 


Voltage 


volts 


Current 


amperes 


Force 


newtons 


Angle 


radians 


Speed 


meters/second 


Rotational Speed 


radians/second 


Torque 


newton-meters 
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3.5.3 Potential References 



The node potentials are all referenced to an arbitrary value called 0. The reference 
frame for this level is a property of the device definition, but must be consistent with the 
reference frame for other device definitions to which the device may be connected. 
Following are suggested reference points: 

Electrical Voltage Volts above Ground Potential 

Mechanical Angle Radians relative to the positive vertical 

Mechanical Rotational Radians per Second relative to stationary 
Speed 

Mechanical System Dependent 

Displacement 

Mechanical Speed meters per second relative to stationary 

If mechanical rotational speeds or mechanical speeds are specified, but the actual angle is 
required within the device calculations, the speed can be integrated. If more than one 
device requires the integration of the speed, then the system modeller must ensure the state 
initial conditions corresponding to the angle or displacement is consistent for all devices. 

If an absolute reference cannot be established for a device, two terminals can be 
defined such that all constitutive relations depend only on the difference between the two 
terminal potentials. This relative definition of potentials is commonly used for modelling 
circuit elements. An ideal transformer for example, is a four terminal device with the 
following constitutive equations: 

V Ip = n(V 2p - V 2m ) + V Ira 
ha, = ■ ha, / n 

bp " 'lm 
hp * ha, 

Note that V ip is defined relative to V lm and is a function of ( V lp - V^). None of the export 
flow variables is a function of the absolute value of any of the potentials. 
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3.5.4 Discontinuity Control 



One of the difficulties with using vectors of orthogonal series coefficients to 
represent waveforms is the poor truncation error performance when approximating 
discontinuous variables or variables having discontinuous derivatives. These 
discontinuities are usually a function of either time or the zero crossing of one of the 
variables. In any case, the time of the discontinuity is often easily determined by the 
device object. If the frequency of the discontinuities is low enough, it would be prudent 
for the device to specify the earliest discontinuity of the interval as a recommended 
recalculation time. 

If the discontinuity is a function of a waveform zero crossing, special care must be 
taken to ensure the device does not continously estimate the zero crossing to be within a 
small increment of tto or ttl and force the time loop to iterate ttl around the 
discontinuity. One way around this problem is for the device to move or remove any 
discontinuities within sb_dt_ave of either tto or ttl in any of its export variables. If 
sb_dt_ave is small enough, then moving the discontinuity should not affect the accuracy 
of the simulation very much yet still prevent the system time loop from hunting for the 
discontinuity by varying ttl. 

If many discontinuities occur in an export variable more frequently than sb_dt_ave, 
then the export variable should be smoothed. The smoothing operation calculates the local 
average of a waveform over the interval [t-sb_dt_ave,t+sb_dt_ave]. In this manner, the 
higher order terms of the export variable are attenuated and the waveform is more likely to 
pass the truncation error test. 
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3.5.5 Consistent Initial Conditions 



Most simulation environments require the user to specify the initial values for all the 
states at time to. In this regard WAVESIM is no different. Unfortunately, determining a 
consistent set of initial conditions which meet some definition of normal operating 
conditions is not an easy task for either a system modeler or a computer program. First of 
all, the concept of a normal operating condition, is not always easy to describe 
mathematically. Furthermore, even if a definition for normal operating condition, can be 
made, there is often much difficulty in determing that condition. 

An ideal solution would be for each device to calculate its own initial conditions 
during the first time increment. If a device is capable of determining an initial condition 
based only on its parameters and the values of its import variables, then the following 
technique can be used: 

1. Define a state called ic, always initialize it to 0. 

2. Define Sufficient Parameters to determine the normal operating condition. 

3. Within the constitutive equations, have a check for the initial value of ic 
equalling zero. If ic = 0 at the beginning of the interval then use the 
equations for the normal operadong condition to determine the initial values of 
the other states. Otherwise use the initial values of the other states as passed to 
the device. In any case, the final value for the state ic should be set to 1. 

This method for determining the initial conditions is well suited for determining the 
initial conditions of the states of rotating machines. Essentially, a load flow is conducted 
in the first time increment to determine the initial state values. 
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3.5.6 Waveform type conversion 

Performing the calculations for the constitutive equations for certain devices may he 
easier to accomplish in one waveform over other waveforms. Converting the import 
variables to a fixed waveform type is permissible and at times desirable. As long as the 
export variables are converted back to the proper type and the jacobians reflect the 
waveform conversions, all should work out well. 

If the export variables depend on higher order tenns of intermediate calculations, 
converting the import variables to waveforms of a length longer than n and performing all 
of the intermediate calculations using this longer length before truncating back to n when 
generating the export variables may be desirable in avoiding excessive truncation errors. 
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Chapter 4 WAVESIM 
4.1 Basic Description 

WAVESIM, a simulation program written in the C programming language, 
demonstrates the algorithms discussed in detail in Chapter 3 for simulating systems of 
nonlinear lumped parameter models representing the electro-mechanical components 
comprising an Integrated Electric Drive system. The general characteristics of WAVESIM 
are: 

1. System and Simulation Parameters specified in a text Input File. 

2. Device Defmitions are in text file device . def . 

3. WAVESIM Performs following 4 tasks: 

A. Reads in Device Definitions and initializes simulation. 

B. Reads Input File and determines devices and nodes of system. 

C. Builds and reduces system into a sequence of blocks. 

D. Writes a MATLAB script file for conducting the simulation. 

4. The actual Simulation is conducted in MATLAB. 

5. Supported Waveform types are: 

A. Data Series. 

B. Fourier Series. 

C. Legendre Series. 

D. Polynomial Expansions. 

E. Chebyshev Series. 

6. Wavefonn operators are MATLAB functions defined in M-files. 

7. Device Constitutive Equations are detailed in MATLAB functions defined in 
M-files. 

8. The present Incarnation of WAVESIM has these limitations: 

A. Subsystems have not been implemented. 

B. System and Device Structural Jacobians must be time independent. 

C. Newton-Raphson is the only equation solving method used. 

Relaxation Techniques have not been implemented. 
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MATLAB was chosen as the environment for conducting the simulation for the 
following reasons: 

1. MATLAB is ideally suited for treating vectors and matrices as abstract data 
types. 

2. MATLAB has built in plotting routines. 

3. The ability to create MATLAB M-fileS which when invoked, execute a long 
series of commands called a Script. M-files can also be used to create new 
MATLAB functions. 

4. MATLAB has many built in functions for analysing matrix properties. 

5. Since WAVESIM is an algorithm demonstration program, speed is not of 
primary concern. Interest in determining if the algorithms work is of higher 
interest than optimizing for speed. 
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4.2 Running WAVESIM 



Under either the UNIX operating system or IBM DOS, WAVESIM is executed by 
entering at the commmand prompt: 

athena% wavesim file. in 

where file, in is an optional entry for the file name of the input file. WAVESIM 
will attempt to read in the device. def file and if successful, will display the following 
header: 

WAVESIM 

Revision 2.0 <> April 1991 

(C) Copyright 1990,1991 by Norbert H. Doerry 

If WAVESIM encountered errors when reading device . def, an error message is 
printed and the program terminates. 

If file . in was not specified on the command line, the user is prompted for a file 
name: 

Enter WAVESIM INPUT file name : 

If instead of a file name q is entered, WAVESIM terminates execution. A directory 
listing can be obtained by entering a ? followed optionally by a file specification (operating 
system dependent). 

Under normal execution of WAVESIM, there is no further interaction with the user. 
WAVESIM automatically creates an output file having the same base filename as 
file . in but having . m as an extension (i.e. file, in becomes file . m). 

NOTE: Do not create input files with . m extensions as these files will be overwritten 
by WAVESIM. Also avoid using file names which are valid MATLAB functions. 

WAVESIM provides extensive support for providing the user with feedback through 
the use of the DEBUG command. Most of the major routines in WAVESIM have a debug 
option for displaying the results of calculations internal to WAVESIM. 
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If errors are found reading either device . def or the input file, WAVESIM displays 
an error message which includes the file name and the line number within the file. 
WAVESIM attempts to continue reading an input file even if errors are detected but will 
only create an output file if no errors are encountered. 
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4.3 Input File Specification 



The Input File describes the system topology, defines the device parameters, and 
specifies simulation paramaters. The basic characteristics of the file are: 

1. ASC II text files. 

2. Lines beginning with %, # or ! are ignored. Empty lines are ignored as well. 

3. Data lines can be continued on the following line if the last characters in the line 
are . . . or \ . 

4. Commands all begin with a key-word. Key-words are case insensitive and 
usually can be truncated to three letters unless a conflict with another key-word 
exists. 

5. Commands and their arguments may be separated by either spaces or tabs. 

6. The contents of other files can be incorporated by using the INCLUDE command. 

7. Single Line Commands have data arguments entered on only one line. 

8. Multiple Line Commands consist of groups of subordinate commands. The group 
must end with a line beginning with the key-word END. 

Here is a summary of the Commands available : 



DEBUG 


Print Debug Information 


DEFAULT 


Default System Parameter Initialization 


DEVICE 


Device Specification 


INCLUDE 


Include another file 


NODE 


Node Parameter Specification 


TIME 


Time Increment Control 
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Example Input File 



% 

% rcrc.in 

% 

debug 

build_system_identify 
build_system_blocks 
f ind_block 
END 

% 

device VDC_SOURCE Vs 
TERMINAL 1 1 
TERMINAL 2 0 
PARAMETER VS 1 . 0 
END 

% 

device RESISTOR R1 
TERMINAL 1 1 
TERMINAL 2 2 
PARAMETER R 0.1 

END 

% 

device RESISTOR R2 
TERMINAL 1 2 
TERMINAL 2 3 
PARAMETER R 1.0 

END 

% 

device INDUCTOR LI 
TERMINAL 1 2 
TERMINAL 2 0 
PARAMETER L 1.0 

END 

% 

device INDUCTOR L2 
TERMINAL 1 3 
TERMINAL 2 0 
PARAMTER L 1.0 

END 

% 

device CAPACITOR Cl 
TERMINAL 1 2 
TERMINAL 2 0 
PARAMETER C 1.0 

END 

% 

device CAPACITOR C2 
TERMINAL 1 3 
TERMINAL 2 0 
PARAMETER C 1.0 

END 

% 
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Example Input File (continued) 



% 

node 1 

scale potential 1.0 



scale flow 
error kcl 
error pot 
end 



% 

default 

Gmin 

Rmin 



1.0 

5e-3 

5e-3 



check both 

error eqn kcl 5e-3 
error eqn pot 5e-3 
error var node 5e-3 
error var flow 5e-3 
error mult kcl 10.0 
error mult pot 10.0 
error mult node 10.0 
error mult flow 10.0 

scale potential 1.0 
scale flow 1 . 0 

max count 1 0 
max int count 6 

alpha init 1.0 
alpha inc init .25 
alpha inc min .05 

diverge start 3 
diverge max cnt 2 
diverge error mult 10.0 

waveform content max .005 
waveform content nbr 2 

wtype 3 

nbr coef 7 
nbr coef min 6 
nbr coef max 14 
nbr data 20 



END 



% 

time 



dt min 
dt max 
dt opt 
dt init 
dt ave 
start 
finish 20 
END 



025 

0 

250 

0 

0 

0 

0 



-no- 



4.3.1 DEBUG 



If DEBUG is specified without any arguments, the command is interpreted as a 
multi-line command. Each of the following lines should contain the name of one of the 
subroutines listed below. If the key-word OFF follows the subroutine name, the debug flag 
for that subroutine is turned off. Otherwise, the debug flag for the specified routine is 
turned on. The last line of the group should begin with the key-word END. 

If DEBUG is specified with arguments, the command is interpreted as a single-line 
command and the arguments should consist of one of the subroutines listed below and 
optionally, the key- word OFF. A single line command does not have an END keyword 
associated with it. 

Here is a list of subroutines for which debug flags have been defined (Note: The 
subroutine names are case sensitive) 

init_devices 

r e a d_de vi c e_de f 

read_f ile 

read_f ile_device 

re ad_f i 1 e_de fault 

read_f ile_node 

r e ad_f i 1 e_t ime 

read_f i le_debug 

build_system 

build_system_identify 

build_system_structural_jacobian 

build_system_blocks 

f ind_block 

print_system_identify 
write file 
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4.3.2 DEFAULT 



If DEFAULT is specified without any arguments, the command is interpreted as a 
multi-line command. Each of the following lines should contain one of the subordinate 
commands listed below. The last line of the group should begin with the key-word END. 

If DEFAULT is specified with arguments, the command is interpreted as a single-line 
command and the arguments should consist of one of the subordinate commands listed 
below. A single line command does not have an END keyword associated with it. 

Here is a summary of the DEFAULT subordinate commands: 



ALPHA 


Continuation Parameter Control 


CHECK 


Error Checking Flags 


DIVERGE 


Divergence Test Control 


ERROR 


Default Error Levels 


GMIN 


Default Node Leakage Conductance 


MAX 


Maximum Iteration Counts 


NBR 


Number of Coefficients Control 


RMIN 


Default Node Series Resistances 


SCALE 


Default Variable Scaling Factors 


WAVEFORM CONTENT 


Waveform Content Limits 


WTYPE 


Waveform Type 
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4 . 3 . 2.1 DEFAULT : ALPHA 



The ALPHA subordinate command specifies the parameters needed to control the 
continuation parameter for nonlinear blocks. 



Command 

ALPHA INIT Value 
ALPHA INC INIT Value 
ALPHA INC MIN Value 



Description MATLAB Variable 

Continuation Parameter sb_alpha_init 
Initial Value 

Continuation Parameter sb_dalpha_init 
Initial Increment 

Minimum Continuation sb_dalpha_min 
Parameter Increment 



For a nonlinear block, the continuation parameter is initialized to the ALPHA INIT 
value. The initial increment for the continuation parameter is specified by ALPHA INC 
INIT. If the block fails to converge, the continuation parameter is progressively 
decremented until the block converges or if convergence fails due to the difference 
between the last value of the continuation parameter that converged and the present value 
of the continuation parameter being less than ALPHA INC MIN. If the block converges, 
the continuation parameter is incremented by ALPHA INC INIT until it equals 1. 

4 . 3 . 2.2 DEFAULT : CHECK 



The CHECK subordinate command determines for nonlinear blocks, whether the 
equation error, the variable correction magnitude, or both should be used for the 
convergence criteria. 



Command 
CHECK EQN 

CHECK VAR 

CHECK BOTH 



Description 

Check only Equation Errors 

Check only Variable 
Corrections 

Check both Equation Errors 
and Variable Corrections 



MATLAB Variable 

sb^che ck_e qn_e r r = 1 
sb_check_var_err = 0 

sb_check_eqn_err = 0 
sb_check_var_err = 1 

sb_check_e qn^err = 1 
sb check var err = 1 
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4.3.23 DEFAULT : DIVERGE 



The DIVERGE subordinate command specifies when and how to check a nonlinear 
block for divergence. After DIVERGE START iterations, if the largest relative error 
increases for DIVERGE MAX CNT iterations and the relative error is at least DIVERGE 
ERROR MULT then the block is assumed to be diverging and the converge_faiiure flag 
is set. 

Command Description MATLAB Variable 

DIVERGE START Value Number of iterations to wait sb_div_start_cnt 

before testing for divergence 

DIVERGE MAX CNT Value Number of iterations to sb_div_max_cnt 

allow relative error to 
increase befor concluding 
divergence 

DIVERGE ERR MULT Value Value of relative error sb_i_div_err 

below which to ignore 
divergence iteration count 
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4 . 3 . 2.4 DEFAULT : ERROR 



The ERROR subordinate command determines for nonlinear blocks, the default 
maximum equation errors and variable corrections which are permissible. These default 
values can be overridden for a specific node with the NODE command. When the 
conituation parameter equals 1, ERROR EQN KCL is the maximum error for the node 
KCL equtions and ERROR EQN POT is the maximum error for the potential difference 
equations. Likewise when the continuation parameter equals 1, ERROR VAR NODE is 
the maximum correction to a node potential and ERROR VAR FLOW is the maximum 
correction to an import flow variable. The ERROR MULT subordinate commands are 
multipliers to the above limits for continuation parameters less than 1. 



Command 


Description MATLAB Variable 


ERROR EQN KCL Value 


Default KCL Equation sys_kcl_err 1 

Maximum Error 


ERROR EQN POT Value 


Default Potential Difference sys_var_err : 
Maximum Error 


ERROR VAR NODE Value 


Default Maximum sys_nd_err 1 

correction to Node 

Potentials 


ERROR VAR FLOW Value 


Default Maximum sys_fv_err 1 

correction to Import Flow 
Variables 


ERROR MULT KCL Value 


Multiplier to ERROR EQN sb i kcl_err 
KCL when continuation 
parameter < 1 


ERROR MULT POT Value 


Multiplier to ERROR EQN sb_i_pot_err 
POT when continuation 
parameter < 1 


ERROR MULT NODE Value 


Multiplier to ERROR VAR sb_i_nd_err 
NODE when continuation 
parameter < 1 


ERROR MULT FLOW Value 


Multiplier to ERROR VAR sb i_fv_err 
FLOW when continuation 
parameter < 1 



Note 1: sys xxx err are actually arrays containing for each equation or variable, either 
the default - value specified here or the overriding value specified in the NODE 
command. 
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4.3.2.5 DEFAULT : GMIN 



The GMIN subordinate command defines the default value for G min . G ^ is used to 
modify the KCL equations to help prevent singular systems. G mn should normally be set 
to 0 unless a singularity problem exists. The value for can be overridden for a 
particular node through the NODE command. 

Command Description MATLAB Variable 

GMIN Value Leakage Conductance to 0 sys_Gmin 1 

Potential 

Note 1: sys_Gmin is actually an array containing the value for G^ for each node: either 
the default value specified here or the overriding value specified in the NODE 
command. 

4.3.2.6 DEFAULT : MAX 

The MAX subordinate command determines the maximum number of 
Newton-Raphson iterations for a nonlinear block before the continuation parameter is 
decremented. MAX COUNT specifies the maximum number of iterations when the 
continuation parameter equals 1 while MAX INT COUNT specifies the maximum 
number of iterations when the continuation parameter is less than 1. 

Command Description MATLAB Variable 



MAX COUNT Value 


Maximum 


number of sb_maxcnt 




Iterations 


when the 




continuation 
equals 1 


parameter 


MAX INT COUNT Value 


Maximum 


number of sb i maxcnt 




Iterations 


when the 




continuation 
less than 1 


parameter is 
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4.3.2.7 DEFAULT : NBR 



The NBR subordinate command controls the number of coefficients the waveforms 
will have. NBR COEF specifies the initial number of coefficients to use. NBR COEF 
MIN is the minimum number of coefficients to use while NBR COEF MAX is the 
maximum number of coefficients. NBR DATA is the number of data points per 
waveform used when generating plots. 



Command 
NBR COEF Value 

NBR COEF MIN Value 

NBR COEF MAX Value 

NBR DATA Value 



Description 

Initial number 
coefficinets 

Minimum number 
coefficients 

Maximum number 
coefficients 



MATLAB Variable 

of n 

of sb_n_min 
of sb n max 



Number of points per sb_n_data 
waveform to use in plots. ' 



4.3.2.8 DEFAULT : RMIN 

The RMIN subordinate command defines the default value for R TOn . R is used to 
modify the Potential Difference equations to help prevent singular systems. R min should 
normally be set to 0 unless a singularity problem exists. The value for R ^ can be 
overridden for a particular node through the NODE command. 

Command Description MATLAB Variable 

RMIN Value Series Resistance for Export sys_Rmin 1 

Potentials 

Note 1 : sys_Rmin is actually an array containing the value for R ^ for each node: either 
the default value specified here or the overriding value specified in the NODE 
command. 
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4 . 3 . 2.9 DEFAULT : SCALE 



The SCALE subordinate command specifies the default scaling parameters for the 
potential and flow variables. The default scaling parameters can be overridden for a 
particular node through the NODE command. 

Command Description MATLAB Variable 

SCALE POTENTIAL Value Default scaling factor for sysjpot^scale 1 

Potentials 

SCALE FLOW Value Default scaling factor for sys_flow_scaie 1 

Flow Variables 

Note 1: sys_pot_scale and sys_fiow_scale are actually arrays containing the scaling 
factors for each node: either the default values specified here or the overriding 
values specified in the NODE command. 

4 . 3 . 2.10 DEFAULT : WAVEFORM CONTENT 



The WAVEFORM CONTENT subordinate command controls the maximum 
allowable truncation error by specifying the maximum waveform content WAVE CONT 
MAX for the last WAVE CONT NBR coefficients of a waveform. 



Command 

WAVE CONT MAX Value 
WAVE CONT NBR Value 



Description MATLAB Variable 

Maximum Waveform sb_max_hh 

Content 

Number of Coefficients to sb_nbr_hh 
apply maximum to. 



4 . 3 . 2.11 DEFAULT: WTYPE 

The WTYPE subordinate command specifies the waveform type to use in the 
simulation 

Command Description MATLAB Variable 

WTYPE Value Waveform Type Indicator wtype 

1 Data Series 

2 Fourier Series 

3 Legencre Series 

4 Polynomials 

5 MATLAB Polynomials 

6 Chebyshev Series 
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4 . 3.3 DEVICE 



DEVICE is always a multi-line command. The command must be entered in the 
following format: 

DEVICE Device_Type Name 

where: 

Device_Type Device Type Name from device . def file. 

Name Name of this particular device. 

The subordinate commands for the DEVICE command are: 

TERMINAL Assign Tenninals to Nodes (mandatory). 

PARAMETER Assign Parameter Values (optional). 

STATE Assign State Initial Conditions (optional). 

All of the terminals as defined in the device .def must be assigned to a node. If the 
parameters or states are not assigned values, the default values specified in device . def 
are used. 

The last line of the command group must begin with the key-word END 

4 . 3 . 3. 1 DEVICE : TERMINAL 

The TERMINAL subordinate command assigns a terminal to a node and must be 
entered in the following format: 

TERMINAL Termlnal_Name Node_Nbr 

where: 

Terminal_Name Terminal Name from device . def file. 

Node_Nbr Serial Number of Node this terminal is attached to. 

All of the tenninals as defined in device . def must be attached to a node of the 
system. 
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4 . 3 . 3.2 DEVICE : PARAMETER 



The PARAMETER subordinate command assigns a value to a parameter of the 
device. If the parameter is a single value as defined in device . def then the parameter 
command must be of the following format: 

PARAMETER Parameter Name Value 



where: 



Parameter_Name Parameter Name from device . def file. 

Value Parameter Value. 

If the parameter is a matrix as defined in device, def then the parameter 
command must be of the following format: 

PARAMETER Parameter_Name MATRIX 

matrix_values 

END 

where: 

Parameter_Name Parameter Name from device . def file. 

matrix_values Parameter matrix. The number of rows and coluntns 

of the matrix must be the same as specified in the 
device. def file. Rows are entered one line at a 
time with columns separated by spaces. 

If a parameter as defined in device . def is not assigned a value, then the default 
values specified in device . def is used. 
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4.3.33 DEVICE : STATE 



The STATE subordinate command assigns an initial value to a state of the device 
and must be entered in the following format: 

STATE State_Name Value 

where: 

State_Name State Name from device . def file. 

Value Initial value of state. 

If a state as defined in device . def is not assigned a value, then the default 
values specified in device . def is used. 
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4.3.4 INCLUDE 



INCLUDE is always a single-line command. The command must be entered in the 
following format: 



The contents of the included file are inserted at the location of the INCLUDE 
command. 

4.3.5 NODE 

NODE is always a multi-line command. The command must be entered in the 
following fonnat: 



INCLUDE File Name 



where: 



File Name 



Name of the file to include. 



NODE Node Nbr 



where: 



Node Nbr 



Serial Number of the node. 



The subordinate commands for the NODE command are: 



ERROR 



Node Error Levels 



RMIN 



NAME 



GMIN 



SCALE 



Specify node G mn value 
Assign a name to the node 
Specify node R mn value 
Specify node scaling factors 



The last line of the command group must begin with the key-word END 
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4.3.5. INODE: ERROR 



The ERROR subordinate command determines for nonlinear blocks, the maximum 
equation errors and variable corrections which are permissible. These values override the 
default values. When the conituation parameter equals 1, ERROR EQN KCL is the 
maximum error for the node KCL eqution and ERROR EQN POT is the maximum error 
for the potential difference equations. Likewise when the continuation parameter equals 
1, ERROR VAR NODE is the maximum correction the node potential and ERROR VAR 
FLOW is the maximum correction to an import flow variable. The ERROR MULT 
subordinate commands of the DEFAULT command are multipliers to the above limits for 
continuation parameters less than 1. 



Command 

ERROR EQN KCL Value 
ERROR EQN POT Value 
ERROR VAR NODE Value 
ERROR VAR FLOW Value 



Description MATLAB Variable 

Maximum KCL Equation sys_kcl_err 1 
Error 

Maximum Potential sys_var_err' 

Difference Error 

Maximum correction to sys_nd_err 1 
Node Potential 

Maximum correction to sys_fv_err 1 
Import Flow Variables 
attached to this node 



Note 1: sys_xxx_err are actually arrays containing for each equation or variable, either 
the default value or the overriding value specified here. 

4. 3.5.2 NODE : GMIN 



The GMIN subordinate command defines the value for G mi „. G ^ is used to modify 
the KCL equation to help prevent singular systems. G min should normally be set to 0 
unless a singularity problem exists. The value for G min overrides the default value. 

Command Description MATLAB Variable 

GMIN Value Leakage Conductance to 0 sys_Gmin 1 

Potential 

Note 1: sys_Grain is actually an array containing the value for G min for each node: either 
the default value or the overriding value specified here. 
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4.3.53 NODE: NAME 



The NAME subordinate command 

Command Description MATLAB Variable 

NAME Node_Name Name of the Node sys_node_name l 

The node name is only used to associate the node serial number to a more 
understandable label. The node name is optional and does not affect computation in any 
way. 

Note 1: sys_node_name is actually an array containing the names of all the nodes. 

43.5.4 NODE: RMIN 

The RMIN subordinate command defines the node value for R^. R mi „ is used to 
modify the Potential Difference equations to help prevent singular systems. should 
normally be set to 0 unless a singularity problem exists. The value for R ^ overrides the 
default value. 

Command Description MATLAB Variable 

RMIN Value Series Resistance for Export sys_Rmin 1 

Potentials 

Note 1: sys_Rmin is actually an array containing the value for for each node: either 
the default value or the overriding value specified here. 

43.5.5 NODE : SCALE 

The SCALE subordinate command specifies the node scaling parameters for the 
potential and flow variables. The scaling parameters override the default values. 

Command Description MATLAB Variable 

SCALE POTENTIAL Value Scaling factor for Node sys_pot_scale 1 

Potential 

SCALE FLOW Value Node scaling factor for Flow sys_flow_scale 1 

Variables 

Note 1 : sys_pot_scaie and sys_f low_scale are actually arrays containing the scaling 
factors for each node: either the default values or the overriding values specified 
here. 
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4 . 3.6 TIME 



If TIME is specified without any arguments, the command is interpreted as a 
multi-line command. Each of the following lines should contain one of the subordinate 
commands listed below. The last line for the section should begin with the key-word END. 

If TIME is specified with arguments, the arguments should consist of one of the 
subordinate commands listed below. A single line command does not have an END 
keyword associated with it. 

The subordinate commands for the TIME command are: 



BREAK 


Insert Break Point 


DT 


Time Increment Control 


FINISH 


Ending Time of Simulation 


START 


Starting Time of Simulation 



4 . 3 . 6. 1 TIME : BREAK 



The BREAK subordinate command inserts a simulation break point which forces a 
waveform boundary to occur at the designated time. Bracketing intervals in which a 
discontinuity will occur with breakpoints can reduce the computational effort required by 



WAVES IM. 






Command 


Description 


MATLAB Variable 


BREAK Time 


Break Point time 


sb^p 1 






sb bp nbr 



Note 1 : sbjbp is actually an array of break points in chronological order. sb_bp_nbr is 
the number of break points. 
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4 . 3 . 6.2 TIME: DT 



The DT subordinate command controls the waveform interval. 



Command 
DT MIN Value 

DT MAX Value 



DT OPTIMUM Value 

DT INITIAL Value 
DT AVE Value 



Description MATLAB Variable 

Minimum Waveform sb_dt_min 

Increment 

Maximum Waveform sb_dt_max 

Increment 

Optimum Waveform sb_dt_opt imum 

Increment 

Initial Waveform Increment sb_dt_init 

Minimum Time Interval of sb_dt_ave 
Interest (Averaging Interval) 



If the time interval is less than DT OPTIMUM, the number of coefficients is less 
then the maximum and a block does not converge, the number of coefficients is increased 
for the next iteration. Otherwise, if the block does not converge the time interval is 
reduced. 



DT AVE is the minimum time interval of interest and is used by devices to smooth 
their export waveforms or to move discontinuity boundaries. 

4 . 3 . 6.3 TIME : FINISH 



The FINISH subordinate command specifies the ending time of the simulation. 



Command 

TIME FINISH Value 



Description MATLAB Variable 

Ending Time of Simulation tl 



4 . 3 . 6.4 TIME : START 

The START subordinate command specifies the beginning time of the simulation. 
Command Description MATLAB Variable 

TIME START Value Starting Time of Simulation tO 
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4.4 Device Definition File Specification 

The device definition file device. def contains the definitions of the device types 
which can be specified in a WAVESIM Input File. The basic characteristics of the file are: 

1. ASC II text files 

2. Lines beginning with %, # or ! are ignored. Empty lines are ignored as well. 

3. Data lines can be continued on the following line if the last characters in the line 

are ... or \. 

4. Commands all begin with a key-word. Key-words are case insensitive and 
usually can be truncated to three letters unless a conflict with another key-word 
exists. 

5. Commands and their arguments may be separated by either spaces or tabs. 

6. The contents of other files can be incorporated by using the INCLUDE command. 

7. Single Line Commands have data arguments entered on only one line. 

8. Multiple Line Commands consist of groups of subordinate commands. The group 
must end with a line beginning with the key-word END. 
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Example device . def File 



% 

% device. def 
% 

% debug init_devices 
debug read__device_def 



device RESISTOR 
Terminal 1 
Terminal 1 
Terminal 2 
Terminal 2 
Parameter 
Function 
Structural 
DD 
DD 

end 

end 

% 

device INDUCTOR 
Terminal 1 
Terminal 1 
Terminal 2 
Terminal 2 
Parameter 
Function 
Structural 
LL 
LL 

end 



Pot VI Import 

Flow II Export 

Pot V2 Import 

Flow 12 Export 

R le-15 
resistor 
Jacobian All 



Pot VI Import 

Flow II Export 

Pot V2 Import 

Flow 12 Export 

L le-15 
inductor 
Jacobian All 



1 

1 



1 

1 



end 
% 

device CAPACITOR 

Terminal 1 Pot 
Terminal 1 
Terminal 2 
Terminal 2 
Parameter 
Function 



VI Export 

11 Export 
V2 Import 

12 Import 



Flow 
Pot 
Flow 
C le-15 
capacitor 

Structural Jacobian All 
IL 
OD 

end 

end 

% 

device VDC_SOURCE 

Terminal 1 Pot 
Terminal 1 
Terminal 2 
Terminal 2 
Parameter 
Function 



VI Export 

11 Export 
V2 Import 

1 2 Import 



Flow 
Pot 
Flow 
VS 1 
vdc src 
Structural Jacobian All 
10 



end 



OD 



end 

% 

device REFERENCE 

Terminal Gnd Pot VO Export 
Terminal Gnd Flow 10 Import 
Parameter Vref 0.0 
Structural Jacobian ALL 
0 



1 

1 



1 

1 



0 



end 

end 

% 

% include load flow definitions 
include loadflow.def 
% 

% include rotating machinery IED Models 
include powersys.aef 
% 

% include other circuit elements 
include circ elm. def 
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4.4.1 DEBUG 



The DEBUG command is always a single-line command and results in the display of 
debug information for a specified routine during the execution of WAVESIM. 

Command Description 

DEBUG init_devices Print Info on Initial System Parameters 

DEBUG read_device_def Print Info on what is read from device . def 

4.4.2 DEVICE 

DEVICE is always a multi-line command. The command must be entered in the 



following format: 


DEVICE Device_Type 


where: 





Dev±ce_Type Device Type Name (must be unique) 

The Device Type Name is used to correlate a given device in an input file with the 
properties of the device as specified here. The subordinate commands for DEVICE are: 

TERMINAL Specify Terminal Variable Properties 



PARAMETER 


Specify Parameters 


STATE 


Specify States 


FUNCTION 


Specify MATLAB function 



STRUCTURAL JACOBIAN Specify Structural Jacobian 
The last line of the command group must begin with the key-word END 
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4 . 4 . 2.1 DEVICE : TERMINAL 



The TERMINAL subordinate command defines the properties of the variables 
associated with a terminal. If the Tenninal is a normal terminal, both the flow and 
potential variables need definitions. Flow variables also require a KCL group number 
KCL which corresponds to the group of tenninals for which KCL can be written internally 
to the device. If the flow variable does not belong to a KCL group, its value should be 0. 
Variable are IMPORT is they are a resource to the device and are EXPORT if they are a 
product of the device. The total number of export variables associated with normal nodes 
must equal the total number of import variables associated with normal nodes. 

Normal Node potentials are defined by either 

TERMINAL TermlnalJName POTENTIAL Varlable_Name EXPORT 
or 

TERMINAL Terminal_Name POTENTIAL Varlable_Name IMPORT 

Normal Node flows are defined by either 

TERMINAL Termlnal_Name FLOW Variable_Name EXPORT KCL 
or 

TERMINAL Terminal Name FLOW Variable Name IMPORT KCL 



Information Node potentials are defined by either 

TERMINAL Termlnal_Name INFORMATION Varlable_Name EXPORT 
or 

TERMINAL Termlnal_Name INFORMATION Varlable_Name IMPORT 

Where 

Termlnal_Name One word name for Terminal 

Variable_Name One word name for Variable 

KCL KCL Group Number (0 if none) 
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4 . 4 . 2.2 DEVICE : PARAMETER 



The PARAMETER subordinate command defines the parameters of the device and 
optionally, declares the default values for the parameters. Parameters can either be single 
valued or a matrix. A single valued parameter is defined by: 

PARAMETER Parameter_Name Default_Value 

where 

Parameter Name One word name for Parameter 

Default_Value Optional Default Value for Parameter 

Matrix parameters for which which no default values are provided are defined by: 

PARAMETER Parameter_Name MATRIX Nbr_Row Nbr_Col 

where 



Nbr_Row Number of rows in Matrix 

0 should never be used 
-1 indicates variable dimensioned 

Nbr_Col Number of columns in Matrix 

0 should never be used 
-1 indicates variable dimensioned 



Matrix parameters for which which default values are provided are defined by: 

PARAMETER Parameter_Name MATRIX Nbr_Row Nbr_Col 
DEFAULT 

Defau lt_Matrlx 
END 



where 



Default_Matrix Default Matrix values, Each matrix row should 

be entered one line at a time with columns 
separated by spaces. 
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4A2.3 DEVICE : STATE 



The STATE subordinate command defines the states of the device and optionally, 
declares the default initial values for the states. States are defined by: 

STATE State_Naae Default_Value 

where 

State_Name One word name for State 

Default_Value Optional Default Initial Value for State 

4 A2A DEVICE: FUNCTION 

The FUNCTION subordinate command is mandatory and defines the MATLAB 
function which defines the device constitutive equations. The MATLAB function is 
specified by: 

FUNCTION MATLAB_Function 

where 

MATLAB Function MATLAB Function name 
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4.4.2.S DEVICE : STRUCTURAL JACOBIAN 



The STRUCTURAL JACOBIAN subordinate command defines the structural 
jacobian matrix of the device for 1 or for all of the waveform types. The structural 
jacobian for all waveform types is specified by: 

STRUCTURAL JACOBIAN ALL 

Structural_Jacobian 

END 



where 



Structural_Jacobian Structural Jacobian Matrix. The Rows 

correspond to Export Variables ordered 
according to the order of definition. Similarly, 
the Columns correspond to Import Variables 
ordered according to the order of definition. 
The elements are Structural Jacobian Codes 
detailed below. 

The structural jacobian for one particular waveform type is specified by: 

STRUCTURAL JACOBIAN Wa veform_ Type 

Structural_Jacobian 

END 



where 



Waveform_Type Waveform Type Code the structural jacobian is 

defined for 



- 133 - 



Structural Jacobian Codes 



Code 


Type of Matrix 


0 


Zero Matrix (all elements are always zero) 


A 


Identity Matrix (always the identity matrix) 


A 


Diagonal Matrix (always a linear main diagonal matrix) 


L 


Linear Matrix (The elements are always constant) 


A 


Nonlinear AC Matrix (see Note 1 ) 


N 


Nonlinear Matrix (The elements may not be constants) 


U 


Unknown (The dependence is unknown (treat as nonlinear)) 



Note 1: An AC Matrix is one for which the constant component of the export variable 
depends only on the constant component of the import variable. The other 
components of the export variable can not depend on the constant component of the 
import variable but are not restricted in any other way. 

Waveform Type Codes 



Waveform Type 


Code 


Undefined 


0 


Data Series 


1 


Fourier Series 


2 


Legendre Series 


4 


Polynomials 


4 


Matlab Polynomials 


5 


Chebyshev Series 


6 
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4.4.3 INCLUDE 



INCLUDE is always a single-line command. The command must be entered in the 
following format: 

INCLUDE Filename 

where: 

File_Nai ne Name of the file to include. 

The contents of the included file are inserted at the location of the INCLUDE 
command. 
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4.5 Adding devices 



Adding New devices to WAVESIM requires the creation of a MATLAB M-file 
defining the device constitutive equations and the addition of an entry in the device . def 
file. 



4.5.1 MATLAB M-FILE 



Creating a MATLAB M-FILE for generating a new device requires adherence to a 
strict function argument list format. The following header indicates the format required by 
WAVESIM: 



function [e, jacob, si, ttl ] = function 1 (stype, i, par r mparl 2 , mpar2? , sO, tt, alpha) 



% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 



FUNCTION 

VERSION 2.5 of 19 April 1991 

(C) Copyright 1990, 1991 by Norbert H. Doerry 
[e , jacob, si, ttl] = function (stype, i, par , sO, tt, alpha) 
FUNCTION creates the values and jacobian matrix for a FUNCTION 



stype = 1 data points 

= 2 fourier series 
= 3 legendre series 
= 4 polynomial 
= 5 MATLAB Polynomials 
= 6 chebyshev series 

i = [il ±2 . . .] where 

il, i2, . . . are column vectors of import variables 

par = [pi p2 . . . ] where 

pi — parameter_l 
p2 = parameter J2 

mparl = matrix parameter parameter_Ml 
mpar2 = matrix paraemter parameter_M2 

sO = [S0_1 S0_2 . . . ] where 

S0_2 = state_l value at tO 

SO 2 — state 2 value at tO 



tt = [tO tl dtave] where 

tO = initial time of the interval 

tl = final time of the interval 

dtave = averaging increment 

alpha = continuation parameter 



- 136 - 



(VcV&dPdPcVdP&dPdPcV&dPcX’c# 



e = [el e2 . . . ] where 

el, e2, . . . are column vectors of export variables 

jacob = Jacobian matrix of e with respect to i 

si = [Sl_l Sl_2 . ..] where 

Sl_l = state_l value at tl 
SI 2 = state 2 value at tl 



ttl = [ntl ntt] where 

ntl = recommended recomputation time this interval 
ntt = recommended ending time next interval 



Note 1: function is the name of the function defining the device. The MATLAB M-FILE 
should be called function . m. 

Note 2: mparl, mpar2, etc. are only specified if the device as defined in device . def 
has matrix parameters. 
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Example MATLAB M-File 



function [e , jacob , si, ttl] = resistor (stype, i, par, sO, tt, alpha) 
% 

% RESISTOR 
% 

% VERSION 1.6 of 25 February 1991 
% (C) Copyright 1990,1991 by Norbert H. Doerry 

% 

% [e , jacob, si, ttl] = resistor (stype, i, par, sO, tt, alpha) 

% 

% resistor creates the values and jacobian matrix for a resistor 
% 

% 

% stype = 1 data points 

% =2 fourier series 

% =3 legendre series 

% =4 polynomial 



% 


i 


= 




vl v2] where vl and v2 are column vectors 


% 


par 


= 




R] where R is the resistance 


% 


sO 


= 




[] 


% 


tt 


= 




tO tl dt] 


% 








tO = initial time of the interval 


% 








tl = final time of the interval 


% 








dt = averaging time interval 


% 

% 

% 


alpha 


= 


continuation parameter 


e 


= 


i 


[il i2] where il and i2 are column vectors 


% 


jacob 


= 


Jacobian matrix of e with respect to i 


% 


si 


= 




[] 


% 


ttl 


= 


1 


[ntl ntt] where 



% ntl recommended recomputation time this interval 

% ntt recommended ending time next interval 



% structural jacobian 

% 

% D D 

% D D 

% 

n = size (i) ; 

n (2) - []; 

tO = tt (1) ; 
tl = tt (2) ; 

dt = tt (3) ; 

% 

ttl = [tl tO] ; 

% 

R = par (1) ; 

% 

si = []; 

% 

Vl = i ( : , l ) ; 

v2 = i ( : , 2) ; 

% 

11 = (vl - v2 ) / R; 

12 = - il; 

% 

% 

e = [il i2 ] ; 

% 

% 

ii = eye (n) ; 

% 

jacob = [ii/R~ii/R;-ii/Rii/R]; 
% 
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4.5.2 device . def File 



A DEVICE entry must be made in the device . def file as described in a previous 
section. Here is an example of the entry made for the resistor: 



% 

DEVICE RESISTOR 

% 

TERMINAL 1 POTENTIAL VI IMPORT 

TERMINAL 1 FLOW II EXPORT 1 

TERMINAL 2 POTENTIAL V2 IMPORT 

TERMINAL 2 FLOW 12 EXPORT 1 

PARAMETER R le-15 
FUNCTION resistor 
STRUCTURAL JACOBIAN ALL 
DD 
DD 

END 



END 



Note: a device can be have multiple entries in device, def to reflect different 
default state initial values and default parameter values. For example, one may desire to 
create a model of a 1000 ohm resistor: 



% 

DEVICE 1K_RESIST0R 

% 

TERMINAL 1 POTENTIAL VI IMPORT 

TERMINAL 1 FLOW II EXPORT 1 

TERMINAL 2 POTENTIAL V2 IMPORT 

TERMINAL 2 FLOW I 2 EXPORT 1 

PARAMETER R 1000 
FUNCTION resistor 
STRUCTURAL JACOBIAN ALL 
DD 
DD 

END 



END 



In this manner, one can develop devices which reflect the specific operating 
parameter of a particular model. A Gas Turbine model for example, could be called 
GT_501K-17 and have all the parameters prespecified for an Allison 50 IK- 17 Gas 
Turbine. 
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4.6 Adding Waveform Types 

Adding a new waveform type requires: 

1. Assignment of a waveform type code. 

2. Writing MATLAB M-File functions for converting to and from the other 
waveform types. 

3. Modification of wconvert . m 

4. Writing MATLAB M-FILE functions for accomplishing the waveform 
operations required by the devices 

5. Modificaiton of wf unction . m files 
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4.6.1 Conversion M-Files 



Here is an example of a conversion M-File for converting a Legendre Series into a 
Polynomial: 

function [poly, jacob] = leg_poly (leg, n) 

% 

% [poly, jacob] = leg_poly (leg, n) 

% 

% Norbert H. Doerry 

% Revision 1.1 21 November 1990 

% 

% LEG_POLY converts a Legendre Series to a Normal Polynomial 
% leg = vector of Legendre Series Coefficients in ascending 
% order 

% n = size of polynomial array to create 

% 

% poly = answer 

% jacob = partial derivative of poly wrt leg 
% 

nl = size (leg) ; 
nl(2) = []; 

% 

if n <= 0 
n2 = nl; 
else 
n2 = n; 
end 
% 

% build the jacobian 
% 

jacob = zeros (n2,nl) ; 

% 

if nl > n2 
nn = n2; 
else 
nn = nl; 
end 
% 

for i=l:nn 

jacob (l:i,i) = legendre (i-1 ) ; 
end 

% 

poly = jacob * leg; 

% 

% 

% 
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Note that a jacobian matrix must be specified for each result with respect to each 
argument. Here is the current version of wconvert . m which is the normal method for 
accessing the conversion routines: 



function [w2, jacob] = wconvert (wl, n, si , s2) 

% 

% WCONVERT 
% 

% VERSION 1.3 of 26 March 1991 

% (C) Copyright 1990.1991 by Norbert H. Doerry 

% 

% [w2, jacob] = wconvert (wl, n, si, s2) 

% 

% 

% WCONVERT converts a waveform of one type to another type and 
% also returns the jacobian of the conversion: 

% 

% w 

% n 

% 

% si 

% 

% 

% 

% 

% 

% 

% 

% s2 

% 

% 



input waveform 

number of points in output waveform 

type of input waveform 
— 1 data points 
= 2 fourier series 
= 3 legendre series 
= 4 polynomial 

= 5 for mat lab polynomial (not implemented yet) 
= 6 chebyshev series 

type of output waveform 



nl = size (wl ) ; 
nl (2) = []; 
if n < 1 
n2 = nl; 
else 

n2 = n; 
end 
% 

% 

if si < 1 | si > 6 

' Illegal waveform type' 
si 

return; 

end 

if s2 < 1 | s2 > 6 

'Illegal waveform type' 
s2 

return; 

end 

if si -= 5 | s2 == 5 

'Illegal waveform type' 

return; 

end 

% 
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% 

if si == 1 

if s 2 == 1 

[w2, jacob] 
return; 

elseif s2 == 2 
[w2, jacob] 
return; 

elseif s2 == 3 
[w2, jacob] 
return; 

elseif s2 == 4 
[w2, jacob] 
return; 

else 

[w2, jacob] 
return; 

end 



datadata (wl, n2) 
data four (wl , n2 ) 
data__leg (wl , n2) 
datapoly (wl , n2) 
datacheb (wl , n2) 



% 

elseif si == 2 
if s2 == 1 

[w2, jacob] 
return; 

elseif s2 == 2 
[w2, jacob] 
return; 

elseif s2 == 3 
[w2, jacob] 
return; 

elseif s2 == 4 
[w2, jacob] 
return; 
else 



fourdata (wl,n2) 
four four (wl , n2) 
f our_leg (wl , n2 ) 
fourpoly (wl, n2) 



[w3, j3] = fourpoly (wl, n2) 

[w2, jj] = polycheb (w3, n2) 

jacob = jj * j3; 
return; 

end 



% 

elseif si == 3 

if s2 == 1 

[w2, jacob] 
return; 

elseif s2 -= 2 
[ w2 , jacob] 
return; 

elseif s2 == 3 
[ w2, jacob] 
return; 

elseif s2 == 4 
[w2, jacob] 
return; 

else 

[w2, jacob] 
return; 

end 



% 

elseif si == 4 

if s2 == 1 

[w2, jacob] 
return; 

elseif s2 == 2 
[w2, jacob] 
return; 

elseif s2 == 3 
[w2, jacob] 
return; 

elseif s 2 =— 4 
[w2, jacob] 
return; 

else 

[ w2 , jacob] 
return; 

end 



= leg_data (wl , n2) 
= leg__four (wl , n2 ) 
= leg_leg (wl , n2) ; 
= leg_poly (wl, n2) 
= leg_cheb (wl, n2) 

= polydata (wl , n2 ) 
= polyfour (wl , n2) 
= poly_leg (wl , n2) 
= polypoly (wl, n2) 
= polycheb (wl, n2) 



else 

if s2 = 1 

[ w2, jaccb] = 
return; 

elseif s2 == 2 
[w3, j3] 



(w2, T j] 

DD = 



33 



]aco. 
return; 
elseif s2 == 

[ w2 , jaccb] 
return; 
elseif s2 = 
[w2, jacob] 
return; 
else 

[w2, jacob] 
return; 
end 



end 



chebdata (wl,n2) ; 

chebpoly (wl, 0) ; 
pclyfour (w3,n2) ; 
j3; 

cheb_leg (wl , n2) ; 
chebpoly (wl, n2) ; 
leg_leg (wl , n2) ; 
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4.6.2 Waveform Functions 



Waveform functions are defined in a similar manner to the conversion files. Here is 
an example of a MATLAB M-File for integrating a polynomial: 

function (p2 , jacob] = poly int(pl,n,c) 

% 

% 

% [p2 , jacob] = poly_int (pi, n, c) 

% 

% Norbert H. Doerry 

% Revision 1.0 of 6 December 1990 

% 

% pi = input polynomial 

% n = number of points in p2 

% c = integration constant 
% 

% p2 = integeral of pi 

% jacob = partial of p2 with respect to pi 
% 

% 

% POLY INT integrates a given polynomial and converts the 
% resuTt to another polynomial of size n 



% 

nl = size (pi) ; 
nl(2) = []; 

% 

% Error checking 
% 

if n < 2 
n2 = nl; 
else 

n2 = n; 
end 
% 

if nl < 1 
p2 = []; 

return; 
end 

% 

% calculate the integration matrix 
% 

^1 = zeros (nl+1 , nl ) ; 

for i = 1 : nl 

jl (i+1 / i) = 1 / i; 
end 
% 

% xx is (-1) A (n-1 ) 

% 

xx ~ ones (1 , n2) ; 
for i = 2 : n2 

xx(l,i) = - xx(l,i-l); 
end 



% 

% calculate the indefinite integral of the polynomial 
% 

pil = jl * pi; 



% convert to a polynomial of the right size 
% 

[p2,j2] = polypoly (pil, n2) ; 

^3 = j2 * jl; 

% convert to a definite integral by adding the constant of 
% integration and subtracting the value of the indefinite 
% integral at x = -1 



jacob = j3 - [xx * 

p2 (1,1) = p2 (1, 1) 



j3 ; zeros (n2-l, nl )] ; 
xx * j3 * pi + c(l,l); 
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Normally, a user would call w_int to integrate a waveform: 



function [w2 , jacob] = w int (wl, n, si, c) 

% “ 

% W INT 
% ~ 

% Version 1.2 of 19 April 1991 
% (C) Copyright 1991 by Norbert H. Doerry 



% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 

% 



[w2, jacob] = w_int (wl, n, si, c) 

W INT integrates a waveform and returns the result into a waveform of 
1:he same type but of possible different length 

wl = input waveform 

n — number of points in output waveform 
si = type of waveform 
= 1 data points 
= 2 fourier series 
= 3 legendre series 
= 4 polynomial 
= 5 for matlab polynomial 
= 6 for chebyshev series 

c = constant of integration 

w2 = waveform which is integral of wl 
jacob = jacobian of w2 with respect to wl 



nl = size (wl) ; 
nl<2) = []; 
if n < 1 
n2 = nl; 
else 

n2 = n; 
end 
% 

% check for illegal waveform type 
% 

if si < 1 | si > 6 

'Illegal waveform type' 
si 

return ; 
end 



if si = 1 

[w2 , jacob] = data int (wl, n2, c) ; 
% ” 

elseif si == 2 

[w2 , jacob] = four int (wl, n2 , c) ; 
% ~~ 

elseif si == 3 

w3, j 3 ] = leg poly (wl,nl) ; 
w4, n4] = poly int (w3, n2, c) ; 

w2, j2] = poly Ieg(w4,n2); 
jacob = j2 * j4 * j3; 

% 

elseif si == 4 

[w2 , jacob] = poly int (wl, n2 , c) ; 
% ~ 

elseif si = 5 

>3, j31 = mplypoly (wl, nl) ; 

>4, j 4 ] = poly_int (w3, n2, c) ; 



% 



'w2, j2] = polymply (w4 , n2) ; 

jacob = j2 * j4 * j3; 



== 6 



elseif si 
[w3 , j3 
[ w4 , i 4 

w2 r J 2 - . 

jacob = j2 * j4 

% 

else 

' error' 
end 



chebpoly (wl , nl) ; 
poly int (w3, n2, c) ; 
polycheb ( w4 , n2 ) ; 
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Notice how the waveform conversion routines are used to implement waveform 
operations which have not yet been defined for a given waveform type. 
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Chapter 5 Simulation Results 

As a demonstration of the capabilities of WAVESIM, the results of three simulations 
are presented here. While these simulations are relatively simple, they include the important 
features of more difficult simulations, yet are not so complicated as to be unverifiable. The 
first simulation of a simple electical circuit containing only linear devices verifies the ability 
of WAVESIM to construct a viable system and limit truncation error by controlling the 
waveform interval and number of coefficients. The second simulation increases the 
complexity by including a nonlinear device and provides a good test of the Newton-Raphson 
solver. The third and final simulation demonstrates the use of a continuation parameter to 
improve the region of convergence of the simulation. 
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5.1 Linear Electrical Circuit 



To demonstrate WAVESIM’s ability to solve linear circuit problems, the circuit 
shown in figure 5.1-1 was simulated. Initially, both capacitors have zero charge and the 
inductor currents are zero as well. The transients of the capacitor voltages and current are 
shown in figure 5.1-2. The simulation was conducted using Legendre Series with the 20 
second simulation time split up among 23 intervals. Eleven intervals were rejected due to 
excessive truncation error. 



The results shown in figure 5.1-2 are identical (to working precision) to an analytic 
solution of the circuit. 

Figure 5.1-2: Linear Electrical Circuit: Simulation Results 



Figure 5.1-1: Linear Electrical Circuit: Schematic 
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The input file specifying the system is given by: 



Input File for Linear Electrical Circuit 



% 

% rcrc.in 

% 

device VDC_SOURCE Vs 

TERMINAL 1 1 

TERMINAL 2 0 

PARAMETER VS 1.0 
END 

% 

device RESISTOR R1 
TERMINAL 1 1 

TERMINAL 2 2 

PARAMETER R 0.1 

END 

% 

device RESISTOR R2 
TERMINAL 1 2 

TERMINAL 2 3 

PARAMETER R 1.0 

END 



device INDUCTOR LI 

TERMINAL 1 2 

TERMINAL 2 0 

PARAMETER L 1.0 

END 

% 

device INDUCTOR L2 

TERMINAL 1 3 

TERMINAL 2 0 

PARAMETER L 1.0 

END 

% 

device CAPACITOR Cl 

TERMINAL 1 2 

TERMINAL 2 0 

PARAMETER C 1.0 

END 

% 

device CAPACITOR C2 

TERMINAL 1 3 

TERMINAL 2 0 

PARAMETER C 1.0 

END 



% 

default 

Gmin 0 
Rmin 0 
rimport NO 
check both 
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error eqn kcl 5e-3 
error eqn pot 5e-3 
error var node 5e-3 
error var flow 5e-3 
error mult kcl 10.0 
error mult pot 10.0 
error mult node 10.0 
error mult flow 10.0 
max count 10 
max int count 6 
alpha init 1.0 
alpha inc init .25 
alpha inc min .05 
alpha inc max .50 
diverge start 3 
diverge max cnt 2 
diverge error mult 10.0 
waveform content max .001 
waveform content nbr 2 
range max .005 
scale potential 1.0 
scale flow 1.0 

stype 3 
nbr coef 7 
nbr coef min 6 
nbr coef max 14 
nbr data 20 
END 

% 

% 

time 

dt min .01 
dt max 2 . 0 
dt opt .250 
dt init . 5 
dt ave 0 . 0 
start 0.0 
finish 20.0 
END 

% 

plot 

potential R1 2 
node 3 
flow C2 1 
END 

Figure 5.1-3 shows the time increment and number of coefficients used for each of the 
intervals. Once the transients start to decay, the number of coefficients are decreased to the 
minimum allowed. 
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Figure 5.1-3 Truncation Error Control 


Interval 


Ending Time (sec) 


Number of 
Coefficients 


1 


0.25 


7 


2 


0.50 


7 


3 


0.75 


7 


4 


1.25 


7 


5 


2.25 


7 


6 


3.25 


6 


7 


4.25 


6 


8 


4.75 


6 


9 


5.25 


6 


10 


6.25 


6 


11 


7.25 


6 


12 


8.25 


6 


13 


8.75 


6 


14 


9.25 


6 


15 


10.25 


6 


16 


11.25 


6 


17 


12.25 


6 


18 


14.25 


6 


19 


15.25 


6 


20 


16.25 


6 


21 


17.25 


6 


22 


18.25 


6 


23 


20.00 


6 
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5.2 Nonlinear Electrical Circuit 



To demonstrate WAVESEM’s ability to solve nonlinear circuit problems, the circuit 
shown in figure 5.2-1 was simulated. Initially, the inductor current is zero. As the inductor 
current builds up, its voltage is clamped by the diode to one diode drop above 1 volt and its 
current ramps up almost linearly. When the inductor voltage falls far enough to tum the 
diode off, the current and voltage both show a normal exponential transient behavior. 
Figure 5.2-2 shows the inductor voltage and current as a function of time. 

Figure 5.2-1 Nonlinear Electrical Circuit: Schematic 




The results shown in figure 5.2-2 were calculated using Legendre Series over seven 
time intervals. Five additional intervals were rejected due to excessive truncation error. 
These results match closely an analytic solution to the circuit. 
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Figure 5.2-2 Nonlinear Electrical Circuit: Simulation Results 



rd.m using LEGENDRE SERIES n = 7 




The input file specifying the system is given by: 

Input File for Nonlinear Electrical Circuit 



% 

% rd . in 

% 

device VDC_SOURCE Vsl 
TERMINAL 1 1 

TERMINAL 2 0 

PARAMETER VS 10.0 
END 

% 

device RESISTOR R1 

TERMINAL 1 1 

TERMINAL 2 2 

PARAMETER R 1.0 
END 

% 

device INDUCTOR LI 

TERMINAL 1 2 

TERMINAL 2 0 

PARAMETER L 1.0 
END 

% 

device DIODE1 D1 

TERMINAL 1 2 

TERMINAL 2 3 

END 

% 
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device VDC_SOURCE Vs2 
TERMINAL 1 3 

TERMINAL 2 0 

PARAMETER VS 1 . 0 
END 

% 

default 

Gmin 0 
Rmin 0 
r import NO 
check both 

error eqn kcl 5e-3 
error eqn pot 5e-3 
error var node 5e-3 
error var flow 5e-3 
error mult kcl 10. 0 
error mult pot 10.0 
error mult node 10.0 
error mult flow 10.0 
max count 10 
max int count 6 
alpha init 1 . 0 
alpha inc init .25 
alpha inc min .05 
alpha inc max .50 
diverge start 3 
diverge max cnt 2 
diverge error mult 10.0 
waveform content max .001 
waveform content nbr 2 
range max .005 
scale potential 1.0 
scale flow 1.0 

wtype 3 
nbr coef 7 
nbr coef min 7 
nbr coef max 10 
nbr data 20 
END 

% 

time 

dt min . 01 
dt max 5 . 0 
dt opt .250 
dt init 5 
dt ave .01 
start 0.0 
finish 10.0 
END 

% 

plot 

potential R1 2 
flow LI 1 
END 
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Figure 5.2-3 Truncation Error Control 
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5.3 Nonlinear Mechanical System 



To demonstrate the ability of WAVESIM to use continuation parameters in simulating 
nonlinear mechanical systems, a mechanical power train was modelled. The acceleration 
characteristic of a ship was determined for a propeller rotating at a constant speed. Figure 
5.3-1 shows a schematic diagram of the system. 



The propeller model is described in Appendix F-8 while the ship dynamics model is 
described in Appendix F-9. Figure 5.3-2 shows the parametric curves used for C T () and 
C Q (). This data is for a three bladed propeller with an expanded area ratio of .5 and an H/D 
ratio of .6 [81]. 

Figure 5.3-3 shows the Residual drag coefficient used in the ship dynamics model. 
This data is from the Taylor Standard Series for a hull with beam to draft ratio of 3.0, 
Prismatic Coefficient (C p ) of .68, and Volumetric coefficient of 0.002. The Frictional Drag 
Coeffient was calculated using the standard 1TTC Line: 



Figure 5.3-1 Nonlinear Mechanical System: Schematic 




m 
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10*CQ and CT 



Figure 5.3-2 Nonlinear Mechanical System: Propeller Characteristics 



3 Blade Propeller Curves : EAR = .5 : II/D = .6 




Figure 5.3-3 Nonlinear Mechanical System: Drag Coefficient 



xlO* 3 Residual Drag Coefficient vs Fr 
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The input file specifying the system is given by: 



Input File for Nonlinear Mechanical System 



% 

% shipmol . in 

% 

% Model of a prime mover attached to prop going to the sea 

% 

device NODE_REF GTl 
TERMINAL 1 1 
PARAMETER Vref 5.0 
END 

% 

device PROP1 prop 
TERMINAL SHAFT 1 
TERMINAL WATER 2 
PARAMETER D 10.0 
PARAMETER w 0.0 
end 

% 

% parameters are rough ones from Sue B Gail 

% 

device SHIPDYN1 ship 
TERMINAL WATER 2 
PARAMETER L 100 
PARAMETER A 3300 
PARAMETER M 15000000 
PARAMETER Madd 1.05 
PARAMETER Ca 0.0004 
STATE Us 0 
end 

% 

Node 1 

SCALE POTENTIAL 1 
SCALE FLOW le-4 

NAME Propeller_Shaft 
Gmin 1 
END 

Node 2 

SCALE POTENTIAL 1 
SCALE FLOW le-4 

NAME Hydrodynamic_U_force 
END 



% 

default 

Gmin 0 
Rmin 0 
rimport NO 
check eqn 

error eqn kcl le-2 
error eqn pot le-2 
error var node le-2 
error var flow le-2 
error mult kcl 10.0 
error mult pot 10.0 
error mult node 10.0 
error mult flow 10.0 
max count 10 
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max int count 6 

alpha init 0.5 

alpha inc init . 25 

alpha inc min . 05 

alpha inc max .50 

diverge start 3 

diverge max cnt 2 

diverge error mult 10.0 

waveform content max .005 

waveform content nbr 2 

range max .005 

scale potential 1.0 

scale flow 1 . 0 

stype 3 

nbr coef 7 

nbr coef min 6 

nbr coef max 10 

nbr data 20 

END 

% 

time 

dt min .25 
dt max 5 . 0 
dt opt 1 . 0 
dt init 2.0 
dt ave 0 . 0 
start 0.0 
finish 7.25 
END 

% 

plot 

% node 1 converted to RPM 

% node 2 converted to Knots (more or less) 

% 

node 1 9.5492966 

node 2 1.8 

flow ship WATER le-5 
flow prop SHAFT le-5 
END 

The results of the simulation using Legendre Series are shown in figure 5.3-4. The 
simulation was broken into 24 intervals shown in figure 5.3-5. An additional 25 intervals 
were rejected due to excessive truncation error. For each iteration, the continuation 
parameter was initially set to 0.5. This value helped assure the initial value of 0 was within 
the convergence region of the nonlinear blocks. While 0.5 was suitable for most iterations, 
several required the continuation parameter be decremented further to achieve convergence. 
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Figure 5.3-4 Nonlinear Mechanical System: Simulation Results 



shipmo2.m using LEGENDRE SERIES n = 7 




As expected, the force on the propeller is greatest during the acceleration of the ship. 
As the ship accelerates, the increased forward velocity on the ship results in smaller torques 
and forces. In reality it is doubtful the motor would be capable of maintaining a constant 
RPM during the acceleration phase. 
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Figure 5.3-5 Truncation Error Control 
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Chapter 6 Conclusions 

In its present fonn, WAVESIM is ideally suited for testing numerical algorithms. 
While it is capable of simulating large systems, the interpretive nature of MATLAB is not 
numerically efficient enough for serious simulations. Careful development of a simulation 
environment based on the techniques explored in WAVESIM should prove effective in 
solving tightly coupled multirate systems of lumped parameter models. 

The simulation environment described in this thesis should be considered a framework 
for future developments. Many improvements are possible and desirable. In particular, the 
following areas need further attention: 

Truncation Error Control 

The present method for controlling truncation error is heuristic and should be 
examined for improvement. Truncation Error propagation should be examined and 
given a theoretical basis. 

Discontinuity Time Prediction 

The accuracy of the methods used in WAVESIM depend partly on the ability to 
predict discontinuities and force them to occur on time interval boundaries. The 
methods used in current models are crude and should be replaced with more robust and 
accurate methods. 

Stability Analysis 

WAVESIM presently does not perform any stability analysis. Since WAVESIM 
abandons the standard state space representation of the system, determining the 
eigenstructure of the system is not easy. A stability measure based on the 
characteristics of individual devices would fit well with the structure of WAVESIM 
and would be quite useful in the design of distributed controls. 

Smoothing Operation 

The smoothing operator for removing the effects of high frequency 
discontinuities needs to be examined to improve its efficiency. How long to make the 
smoothing interval is a question which has not been satisfactorily answered. 

Partitioning and Relaxation 
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The approach WAVESIM uses for developing the set of system equations is 
ideally suited for use with relaxation methods if the system is weakly coupled. An 
extension to the structural Jacobian to include matrix norms would greatly simply the 
task of partitioning the system into a set of weakly coupled blocks which internally are 
strongly coupled. Each individual block would be solved using Newton-Raphson with 
the system solved using a relaxation technique. Unfortunately, the process of 
constructing a system matrix of norms from device matrix norms is presently not 
possible because arithmetic operators for matrix norms have not been identified. 

Overall, WAVESIM has been very successful in developing the algorithms for building 
systems in terms of device functions, treating waveforms as an abstract data type, and 
employing the structural Jacobian matrix to reduce the system into a sequence of smaller 
blocks. Much work remains, but the foundation of a waveform based simulator capable of 
handling tightly coupled multirate simulation problems is contained within WAVESIM. 
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Appendix A: Glossary 



Block 

Continuation 

Parameter 

Device 

device . def 

Device Jacobian 

Device Structural 
Jacobian Matrix 

Export Variable 



A subset of a system’s equations and variables which must be solved 
simultaneously. Blocks are organized into a sequence where 
variables determined in a previous block may be used in following 
blocks. 

A technique to enlarge the convergence region of a nonlinear system 
by using the solution to a linear system as the initial guess for the 
solution of another system which is a combination of the linear and 
nonlinear systems. The process is repeated with each iteration 
increasing the nonlinear portion until the solution to the nonlinear 
system is determined. The continuation parameter determines the 
relative proportion of the nonlinear system: 0 for the linear system 
and 1 for the desired nonlinear system. 

A device is a mathematical model of a physical piece of equipment 
comprising a system. Devices interact with one another through 
interface variables which are associated with other device interface 
variables through terminals connected at nodes. The equations 
describing a given device type are specified in the device definition. 
A given instance of a device also has associated parameters and 
nodal connections. 

A file for describing a device definition. Each device type has an 
entry describing the device type name, terminals, states, parameters, 
structural Jacobian, and MATLAB M-File containing the 
constitutive equations. 

A matrix whose elements are the partial derivatives of the export 
variables of a device with respect to the device import variables. 

A matrix describing the dependence of a device’s export variable 
with respect to the import variables. The dependence is specified by 
a matrix whose elements are a code indicating if the dependence is 
zero, identity, diagonal, linear, or nonlinear. 

An interface variable (either a potential or flow variable) of a device 
which is explicitly defined by the device constitutive equations. A 
device takes import variables as input and produces export variables. 
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Flow Variable 


An interface variable (either an export or import variable) associated 
with a normal terminal of a device which corresponds to a quantity 
satisfying Kirchhoff’s Current Law at nodes. Examples of flow 
variables are currents, forces, and torques. 


^mln 


A modification to the KCL equations at a node corresponding to the 
insertion of a conductance to the 0 potential. Used to prevent 
singular systems. 


Import Variable 


An interface variable (either a potential or flow variable) of a device 
which is implicitly defined by the device constitutive equations. A 
device takes import variables as input and produces export variables. 


Information 

Terminal 


A terminal of a device having only a potential associated with it. 
Used to convey energyless information between devices. 


Interface Variable 


Variables through which devices communicate energy and 
information transfer to other devices. Interface variables are 
associated with terminals, can be classified as either flow or 
potential variables and can be classified as either import or export 
variables. 


KCL 


Kirchhoff’s Current Law which states the sum of the flow variables 
attached to a node is zero. 


KCL Equation 


Equates the sum of the flow variables attached to a node to zero. 



KCL Group If a subset of a device’s flow variables add to zero by definition. 



Number 


then the elements of such a subset have a device-unique nonzero 
group number. Flow variables which do not belong to such a subset 
have a 0 KCL Group Number. 

KCL Group Numbers are used to determine possible singular 
systems due to linear dependence of system KCL equations. 


MATLAB M-File 


Text files of MATLAB commands for creating new MATLAB 
functions or executing scripts. 


Newton-Raphson 

Method 


An iterative technique for solving systems of nonlinear equations 
which uses the Jacobian Matrix to generate corrections to the system 
variables. 
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Node 



Normal Terminal 

Parameter 

Potential 

Difference 

Equation 

Potential Variable 



Rmln 



Smoothing 

Operator 



State 



A connection point for connecting terminals of one or more devices. 
If at least one normal tenninal is attached, the node is a normal node 
and a system KCL equation is written to equate the sum of all the 
attached flow variables to zero. If only information terminals are 
attached to a node, the node is an information node. All nodes have 
an associated node potential. 

A terminal having both a potential and flow variable. Used to 
simulate energy transfer between devices. 

A variable which does not change throughout the simulation. 
Usually refers to machine ratings, resistances, time constants, etc. 

Each export potential variable in a system has an associated 
potential difference equation equating to zero the difference between 
the potential of the node to which the variable is attached and the 
value of the export potential. 

An interface variable (either an import or export variable) associated 
with either a normal or information node. All of the potential 
variables attached to the same node are equal to the potential of the 
node. 

A modification to a potential difference equation corresponding to 
the insertion of a series resistance. Used to prevent singular 
systems. 

A waveform operator for removing the high order w'aveform content 
of its argument by returning a w'aveform which is the convolution of 
the argument with a square pulse. The returned waveform is 
effectively the local average of the argument waveform. The 
smoothing operator removes unnecessary detail from a waveform 
and improves the representation of the desired properties of the 
waveform w'ith fewer coefficients. 

A state is a device variable whose value is retained between 
waveform intervals. Constants of integration and device operating 
modes are the most common uses of states. 
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Structural Jacobian 
Code 

Subsystem 

System 

System Jacobian 

System Structural 
Jacobian Matrix 

System Variable 
Terminal 

Waveform 

Waveform Content 



A code indicating the nature of an element of a Jacobian matrix: 

0 Zero Matrix 

1 Identity Matrix 
D Diagonal Matrix 
L Linear Matrix 

A Type A nonlinear Matrix 
N Nonlinear Matrix 
U Unknown 

A subset of the devices of a system which are grouped together and 
solved independently of other devices and subsystems. Subsystems 
have not been implemented in WAVESIM. 

A group of devices and subsystems and the nodes interconnected 
them. 

A matrix containing the partial derivatives of the system equations 
with respect to the system variables. 

A matrix describing the dependence of a system’s equations with 
respect to the system variables. The dependence is specified by a 
matrix whose elements are a code indicating if the dependence is 
zero, identity, diagonal, linear, or nonlinear. 

The set of system variables is composed of all the node potentials 
and all the device import flow variables. 

A modelling analogy to a physical attachment point on a device. 
Normal terminals have an associated flow and potential variable and 
are used to model the transfer of energy into and out of a device. 
Information terminals have only a potential variable and are used to 
convey information between devices. 

A representation of a variable over a given time interval consisting 
of a vector of coefficients and a waveform type indicator for 
specifying how the coefficients should be interpreted. Common 
waveform types are Legendre Series, Chebyshev Series, 
Polynomials and Data Points. 

The magnitude of a coefficient of a waveform divided by the square 
root of the sum of all the waveform coefficients. The Wave fo mi 
Contents of the higher order coefficients are used to determine if the 
truncation error is negligible. 
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Waveform 

Indicator 

WAVESIM 



Type An indicator specifying how the coefficients of the waveform vector 
should be interpreted. Common waveform types are Legendre 
Series, Chebyshev Series, Polynomials and Data Points. 

A numerical algorithm development program incorporating the 
systematic treatment of waveforms as a data type, the terminal 
description of devices, and the use of structural Jacobians in system 
reduction. 
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Appendix B: Continuation Parameter Pitfalls 

If used properly, continuation parameters can help enlargen the region of convergence 
of an iterative scheme. This section will show how continuation parameters can fail due to 
bifurcations of solutions. 

Take for example, the following system of two equations and two unknowns 
F(x,y) = 0: 

F,(x,y) = y-(x 3 -x) = 0 
F 2 (x,y) = y-(Mx+B) = 0 

Initially, set M = 0 and B = 1.875. From the following figure, it is obvious the solution 
is the intersection of the two curves and falls at the point (1.5,1.875). 

Figure B-l: Solution to y = x 3 - x and y = 1.875 




To solve this system with a continuation parameter, we create a new function H(x,y,a) 
which is formed by combining F(x,y) with a linear system G(x,y): 

G l (x,y) = y-(mx + b) = 0 
G 2 (x,y) = y-(Mx+B) = 0 
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H(x,y,a) = cxF(x,)’) + (l -ot)G(x, v) = 0 



The modeller now has the choice of selecting m and b. A natural choice would be a 
linearization about a given point. If we linearize about x - 0, the values are m = -1 and b - 0. 
The following figure shows the results of this selection: 

Figure B-2: Continuation Method for m=- 1 b= 0 A/=0 Z?=1.875 




ROOT LOCUS for y = 1.875 y = a(x A 3-x) + (a-l)(-x) 



6 - 
4 - 
2 - 
0 - 
- 2 - 
-4- 
- 6 - 



-10 -8 -6 -4 *2 0 2 4 6 8 10 
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a 


x Root Locus Points 

y = o(a : 3 - x) + (1 - a) (-x) 
y = 1.875 


0 






-1.8750 


0.0100 


10.8310 


-8.8820 


-1.9490 


0.0200 


7.8686 


-5.8222 


-2.0464 


0.0400 


5.7569 


-3.2569 


-2.5000 


0.0421 


5.6274 


-2.8637 


-2.7637 


0.0422 


5.6214 


-2.8107 -0.0613i 


-2.8107 + 0.0613i 


0.0600 


4.8125 


-2.4063 - 0.8387i 


-2.4063 + 0.8387i 


0.1000 


3.8553 


-1.9277- 1.071 2i 


-1.9277+ 1 .07 1 2i 


0.2000 


2.8743 


-1.4372 - 1.09371 


-1.4372+ 1.0937i 


0.0(500 


2.1609 


-1.0804- l.OOlOi 


-1.0804+ l.OOlOi 


0.5000 


1.9746 


-0.9873 - 0.9614i 


-0.9873 + 0.9614i 


0.7000 


1.7263 


-0.8632 -0.898H 


-0.8632 + 0.898 li 

' " " " ■' ' 


1.0000 


1.5000 


-0.7500 - 0.8292i 


-0.7500 + 0.8292i 



Note the solution for a = 0 is (-1.875,1.875) which is not very close to the desired 
solution for a= 1. Furthermore, as a increases slightly, it actually becomes slightly more 
negative until the nonlinear curve no longer intersects the linear equation in the left hand 
plane. At this point, the solution has a discontinuity and jumps into the right hand plane with 
a value for x much larger than the solution. The root locus for x as a goes from 0 to 1 clearly 
shows this. Hence for this selection of m and b , the use of the continuation parameter makes 
the job of solving the system tougher instead of easier. 

If we choose different values for m and b, the situtation may change. Say for example, 
we set m = 1 and b - 0. This selection appears to work well as can be seen with the 
following figure: 
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Figure B-3: Continuation Method for m = 1 b=0 A/=0 Z?=L875 




ROOT LOCUS for y = 1.875 y = a(x*3-x) + (a- IX*) 
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a 


x Root Locus Points 

y = cx(r 3 -x) + (1 - a)x 
y = 1.875 


0 


1.8750 






0.0400 


1.7891 


-0.8945 - 5.0399i 


-0.8945 + 5.0399i 


0.2000 


1.6440 


-0.8220 -2.2421i 


-0.8220 + 2.2421i 


0.5000 


1.5536 


-0.7768 - 1.3455i 


-0.7768 + 1.3455i 


1 1.0000 


1.5000 


-0.7500 - 0.8292i 


-0.7500 + 0.8292i 



The solution for a = 0 is close to the solution and as a increases, it rapidly converges 
on the desired solution (1.5,1.875). We should not rejoice however, because even this 
selection can fail for other choices for M and B. For example, if M - 2.5 and B = -3, the 
following figure demonstrates a discontinuity in the solution path: 

Figure B-4: Continuation Method for m= 1 6=0 M- 2.5 B-- 3 
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ROOT LOCUS for y = 2.5x-3 y = a(x*3-x) + (a-l)(x) 



6- 

4 - 
2 

0 - 
- 2 - 
-4 - 
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a 




x Root Locus Points 

y = oc(x 3 -x) + (l - a)x 

y=2.5y-3 


0 






2.0000 


0.0100 


-13.2173 


11.1887 


2.0286 


0.0200 


-9.6223 


7.5604 


2.0619 


0.0400 


-7.0779 


4.9274 


2.1505 


0.0735 


-5.4659 


2.7706 


2.6953 


0.0736 


-5.4628 


2.7314 -0.0326i 


2.7314 + 0.0326i 


0.S900 


-5.2778 


2.6389 - 0.3761i 


2.6389 + 0.376U 


0.1000 


-4.8192 


2.4096- 0.647 li 


2.4096 + 0.647 li 


0.3000 


-3.1844 


1.5922 -0.7780i 


1.5922 + 0.7780i 


0.5000 


-2.6891 


1.3445 -0.6507i 


1.3445 + 0.65071 


1.0000 


-2.2047 


1 .1024 - 0.381 5i 


1.1024 + 0.38 15i 

... J 
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The bottom line is that it may not be possible to develop a transformation function 
whose solution vector is always continuous. Any information known as to the region where 
the probable operating point lies should be used in directing the solution to that region. For 
this example, if x is known to be constrained to the interval [-55] and M is known to be less 
than 17.75 (,75*5 2 - 1 is the slope of the line tangent toy = a 3 - x and passing through (5,120) 
) then y is also constrained to the interval [-120 120]. If we use as our linearizing function 
the line connecting (-5,-120) and (5,120) it is clear the root locus will also remain within the 
constraints for any value of M or B meeting the constraints at a = 1 : 

y = o(a 3 - a) + ( 1 - a) 24a 

Figure B-5: Continuatin method for m- 24 £=0 M-2.S B=- 3 
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ROOT LOCUS for y = 2.5* -3 y = a(* A 3-*> + (a- 1X24* ) 




a 


x Root Locus Points 

y - a(x 3 - x) + (1 - <x)24jc 
y = 2.5y-3 


0 


0.0789 -13.7847i 


0.0789 +13.7847i 


-0.1395 


0.4000 


0.0789 -13.7847i 


0.0789 +13.7847i 


-0.1579 


0.2000 


0.0909 - 9.0843i 


0.0909 + 9.0843i 


-0.1817 


0.3000 


0.1070-6.83381 


0.1070 + 6.83381 


-0.2141 


0.4000 


0.1301 - 5.36661 


0.1301 +5.3666i 


-0.2603 


0.5000 


0.1657 -4.2523i 


0.1657 + 4.2523i 


-0.3313 


0.6000 


0.2265 -3.3147i 


0.2265 -1- 3.31471 


-0.4530 


0.7500 


0.4476 - 2.0659i 


0.4476 + 2.0659i 


-0.8952 


0.9500 


0.7291 - 1 .37441 


0.7291 + 1.37441 


-1.4582 

l 


0.9500 


0.9945 - 0.77371 


0.9945 + 0.7737i 


-1.9890 


1.0000 


1.1024 - 0.38 15i 


1.1024 + 0.381 5i 


-2.2047 
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For this example it is actually quit easy to determine if a bifurcation will occur. At a 
bifurcation, the x root locus points satisfy the following relationship: 

(x - cf (x - d) = 0 

A- 3 + (~d -lc)x 7 + (c 2 + 2 cd)x + (~c 2 d) 

where c is the multiple root whose paths will deviate from the real x-axis and d is the 
root staying on the x-axis. Now the actual equation defining the roots is given by: 

ocx 3 + ((l - a )m - a -M)x +(1 - a )b -B = 0 

Equating terms we get: 

-d - 2c = 0 

c 1 + 2cd = — ((1 -a )m - a -M) 
a 

-c 2 d = -(( l-a)b-B) 
a 

solving this system for c, d, and a, we get: 

d =-2c 



c = 



(1-a )b J1 B V 
2a j 



(1 - a )m - a -M + 




(1 - a)b -JB Y 
2a j 



= 0 



If one of the solutions for a is a real number in the interval [ 0 , 1 ], then there will be a 
bifurcation and possibly a discontinuity in the path. If two of the roots approach from +<» 
and -oo along the real axis and a solution for a exists in the interval [ 0 , 1 ], then there will 
definitely be a discontinuity in the solution path. If two roots appraoch from off the real axis, 
combine at the bifurcation point, then travel in the +x and -x directions, there will be three 
real solutions for x and the solution path will converge onto one of them. If there is no real 
solution for a in the interval [ 0 , 1 ], then there will be no bifurcation, no discontinuity in the 
solution path and the solution will be unique. 
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Appendix C: Load Flow Example 

The method for building systems can be applied to static simulations for determining 
equilibrium points of systems. The traditional load flow is representative of this type of 
problem. Figure C-l shows a three bus load flow example consisting of four device types: 
PV Generator, VD Generator (Slack Bus), PQ Load, and a transmission line. 

Figure C-l: 3 Bus Load Flow Example 
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C-l: Device Definitions 



C-l.l: PV Generator 



Interface Variables 



Terminal Potential Variable Flow Variable 



VQ V (export) Q (import) 

DP D (import) P (export) 



The import X imp and export X eip vectors are defmed by: 



imp 




CX P 




(KCL Group) Type 

(0) Normal 
(0) Normal 



Parameters 

P c Scheduled Generator Power 

V c Scheduled Generator Voltage 

Equations 



Device Structural Jacobian 



V = V C 
P = -P G 



The device structural jacobian is given by: 



Device Jacobian 



Jds ~ 



'0 

0 



0 ‘ 

0 



The device jacobian is given by: 



0 0 






0 
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C-1.2: VD Generator (Slack Bus) 
Interface Variables 



Terminal 



Potential Variable Flow Variable 



VQ 

DP 



V (export) 
D (export) 



Q (import) 
P (import) 



The import X ^ and export X vectors are defined by 



X = 

imp 



Q 

p 



x = 

exp 



V' 

D 



(KCL Group) Type 

(0) Normal 
(0) Normal 



Parameters 



V G Scheduled Generator Voltage 

D c Scheduled Generator Angle 

Equations 

V = V C 

d = d g 

Device Structural Jacobian 



The device structural jacobian is given by: 



■Ids ~ 



O' 

0_ 



Device Jacobian 



The device jacobian is given by: 






'0 

0 



O' 

0 
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C-1.3: PQ Load 
Interface Variables 



Terminal Potential Variable Flow Variable 

VQ V (import) Q (export) 

DP D (import) P (export) 

The import and export X exp vectors are defined by: 



X, 



imp 



~V~ 

D 



(KCL Group) Type 

(0) Normal 
(0) Normal 



exp 




Parameters 

P L Scheduled Load Real Power 

Q l Scheduled Load Reactive Power 

Equations 



P = P L 

Q = Ql 



Device Structural Jacobian 



The device structural jacobian is given by: 



Device Jacobian 



Jos — 



'0 

0 



0 " 

0 _ 



The device jacobian is given by: 



J D = 



O' 

0 
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C-1.4: Transmission Line 



Interface Variables 



Terminal 


Potential Variable Flow Variable 


(KCL Group) Type 


VQ1 


Vj (import) 


Q , (export) 


(0) Normal 


DPI 


Dj (import) 


Pj (export) 


(0) Normal 


VQ2 


V 2 (import) 


Q 2 (export) 


(0) Normal 


DP2 


D 2 (import) 


P 2 (export) 


(0) Normal 


The import 


and export X exp 


vectors are defined by: 





v; 



x. 



imp 






re.i 



exp 



02 



P 2 



Parameters 

R Transmission Line resistance 

X Transmission Line reactance 

Equations 

Obtain Y: 



A = 



B =- 



R 

R 2 + X 2 

X 



R 2 +X 2 



y = ^[a 2 ~+b 2 

Dy — atan2(fi,/t) 
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Calculate Side one current 



I m = V X Y cos (D x + D y ) - V 2 Y cos(Z ) 2 + D y ) 
7 1; = V X Y sin (£>, +D y ) - V 2 Y sm(D 2 + D Y ) 

Calculate Side two current 




Calculate real and imaginary parts of the voltages 

V ut = V x cos (£>,) 
V\i~ sin(£>j) 

^2 R ~ 1^2 COS(Z) 2 ) 
V^V^sin^) 

Calculate the export variables (Powers) 

P^VutTv + VuTu 
Q \ = + V\jK r 

= ^IR^IR ^21^21 

Ql ~ ~^2R^7J ^2J^2R 

Device Structural Jacobian 





N 


N 


N' 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 
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Device Jacobian 



Calculate the Partial derivatives of the voltages with respect to the import variables: 

n 



dx, 



= [cos (D,) -V^sin^) 0 0] 



imp 



dVy 

dx, 



= [sin(D,) V,cos(D,) 0 0] 



imp 



dV- 



2R 



dX, 



= [0 0 cos (D 2 ) - V 2 sinfDJ] 



imp 



dV, 

dX, 



2 I 



= [0 0 sin (D 2 ) V 2 cos(D 2 )] 



imp 



Calculate the partials of the currents with respect to the import variables: 

9/,n 

— —=[Ycos(D l +Dy) -YV l sin(D, + D Y ) -Ycos(D 2 +D y ) YV 2 sm(D 2 +D Y )] 
dX imp 

dl u 

— — =[rsin(£>,+£> y ) YV t cos(D, +D Y ) -Ysm(D 2 + D T ) -YV 2 cos(D 2 + D y )) 
dX mp 

dim dli jt 

dx~ = ~dx~ 

din dl u 

dx~ = ~dx~ 
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Calculate the jacobian matrix 





'-Iu 


A* 




-V» 


0 


0 


0 


0 


II 


/« 


A/ 




Vy 


0 


0 


0 


0 


0 


0 


0 


0 


"A/ 


Aft 


Vv 


-Vvi 




0 


0 


0 


0 


^2R 


1 11 


y» 


Vy 



avv 

dX imp 

dv v 



dx, 

dl 



imp 



\R 



dX mp 
dly 

dx~ 



imp 



1R 



dv. 

dX~ 
dV v 
dX ; , 
dl 



imp 



2 R 



dX imp 

dl 

dX~_ 



- 194 - 



C-2: Network Description 

Figure C-2-1 details the device interconnections of the 3 Bus system shown in Figure 

C-l. 



Figure C-2-1: 3 Bus Loadflow Block Diagram 
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C-2.1: Variable Labeling Convention 

For this example, the following convention will be used for labeling variables and 
functions: 

Device Terminal Variables: 

aa Device Name 

bb Variable Name 

c n- normal terminal 

i = information terminal 

d i = import variable 

e = export variable 

/ p = potential variable 

/ = flow variable 

Device import variable vector 

aa Device name 

Device export variable defining function 

aa Device Name 

bb Variable Name 

c n - normal terminal 

i = information terminal 

d e - export variable 

/ p = potential variable 

f = flow variable 

Device Jacobian 

Device Jacobian Element y M _ Wjs 

aa Device Name 

bb Export Variable Name 

gg Import Variable Name 

System Variables: Node Potentials V„ 

n Node Serial Number 

System Variables: Flow Variables /^j,* 

aa Device Name 

bb Variable Name 
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System Equation: KCL g„() 

n Serial number of node KCL is applied to 

System Equation: Potentials g n ^ _M>0 

n Serial number of node 

aa Device Name 

bb Export Potential Variable Name 

System Jacobian Element: KCL vs Node Potential J sySKm 
System Jacobian Element: KCL vs Import Flow J sys „ ^ _ bb 
System Jacobian Element: Potential Eqn vs Node Potential J sys ccjU m 
System Jacobian Element: Potential Eqn vs Import flow J sys cc ddJul j, h 

n Serial number of KCL node 

m Serial number of Node Potential 

aa Flow Variable Device Name 

bb Flow Variable Device Variable Name 

cc Potential Equation Potential Device Name 
dd Potential Equation Potential Variable Name 
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C-2.2: Network Specification 



Now that the variable labeling convention has been addressed, it is time to define the 
devices and the network interconnecting them. 

PD Generator G1 

Terminal Potential Variable Flow Variable Node 

VQ X G!Vnep X G1 _£_nif 1 

DP X GIJ)_nep X Gl_P_nif 4 

Parameters 

V c 1.0 PU 

D c 0.0 RAD 

Import Vector: 



^Gl _Q 

I G1_P 

PV Generator G2 



Terminal 


Potential Variable 


Flow Variable 


Node 


VQ 


X G2_V_nrp 


X G2j)_nif 


2 


DP 


X G2_V_nip 


X G2_P_ntf 


5 



Parameters 

P G 0.5 PU 

V G 1.05 PU 

Import Vector: 

X G2_Q_mf 




X G1J = 



K Gl_Q_nif 
_ X Gl_P_m}_ 
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PQ Load L3 



Terminal 



Potential Variable Row Variable 



Node 



VQ X U_V_nip 

DP X U_D_nip 



X UJ)_ntf 

X L3_P__nef 



Parameters 



P L 0.6 PU 

Q l 0.3 PU 

Import Vector: 



x uj = 



X uy_nip 

X U_D_mp 



v; 

v 6 



Transmission Line T12 



Terminal Potential Variable Flow Variable Node 



VQ1 

DPI 

VQ2 

DP2 

Parameters 



X T12_Vl_nip 


X T12_Ql_nef 


X T12_Dl_nip 


X T12_P1 _nef 


X T12_V2_nip 


X T12 _Q2_nef 


X T12J)2jnip 


X T12_P2jruf 



R 0.15 PU 

X 0.60 PU 



Import Vector: 



X Tl2_yi_n\p 




'v; 


X T 12 _D1 _nip 




v t 


X T12_V2_ni P 




V. 


_ X T 1 2 _D2 _rup _ 




1 



1 

4 

2 

5 
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Transmission Line T13 



Terminal 


Potential Variable 


Flow Variable 


Node 


VQ1 


X T13_V1 jnip 


X TJ3 


1 


DPI 


X T13_Dljnip 


X T13JPl jnef 


4 


VQ2 


X T13_V2jnip 


X T13 S>2j*<f 


3 


DP2 


X T13_D2_nip 


X T13 JP2 jnef 


6 


Parameters 








R 


0.05 PU 






X 


0.20 PU 







Import Vector: 



X T13 i ~ 



A 'T13_Vl_ni P 

X T13_Dl_m P 

X T13_V2_m P 

X T13_D2_mp 





1 




V 4 




Vy 




t 



Transmission Line T23 

Terminal 



VQ1 

DPI 

VQ2 

DP2 

Parameters 

R 

X 



Potential Variable 


Flow Var 


X T23_Vl_nip 


X T23 


X T23_Dl_nip 


X T23JPljnef 


X T23_V2_nip 


X T23_Q2_nef 


X T23_D2_nip 


X T23JP2_nef 



0.10 PU 
0.40 PU 



Import Vector: 



k T23_ 





X T23_V1 jrxlp 




l 

i 




X T23J)l_rup 




^5 




X T23 _V2 _nip 




^3 




_ X T23 _D2 _nip _ 




1 



Node 

2 

5 

3 

6 
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C-2.3: System Variables and Equations 

There are nine system variable and equations associated with this example. There 
are the six node potentials plus three import flow' variables ordered in the follow'ing 
manner: 

x^[V t V 2 V 3 V 4 V s V 6 I GIJ2 I CIP I G2 J 

The nine system equations are composed of six Kirchhoff Current Law equations and 
three potential equations: 

8\( X sys) = ^Gl _Q+ X T12J21_nef+ X T13 J)1 _nrf 
gl( X sys) — I G2J2 + X T12 _Q2_n*f + X T23 J)1 _n*f 
Sl&sys) ~ X U_Q_rxef + X Tl3_Q2_nef + X T23_Q2_ntf 
8 a ( X sys) = ^G1_P X T12_P1 _nef + X T13 _Pl _nef 

8s( X sys) = X G2 J>_nef + X Tl2_P2_nef + X T23_Pl _nrf 
8(>( X sys ) ~ X U_P_nef + X T13_P2_nef+ X T23_P2_n*f 
8\jGl_v( X sys) = ^1 “ X G1 _V_rurp 
82_G2_v( X sys) = ^2 “ X G2_V_rurp 
8 A_G1 _D^- X sys^ ^4 X G1 JD _ncp 
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C-2.4: System Structural Jacobian Matrix 

The equations for generating the system jacobian matrix are given by: 

gl(*sys) 

Jsys_lj —Jt12_Q1V1 = N +N 

Jsys_ 1_2 = Jt12 _Q1V2 ~ ^ 

Jsys_ 1.3 ~Jt13 _Q1-W = ^ 

1_4 = ^ T 12 _Q1 _D1 +Jt13_Q1_D1 = N +N 
^sysJJS = Jt12_Q1_D2 ~ ^ 

^ sys_\_6 ~ Jt13_Q1_D2 ~ ^ 

^ sys 1 G1 Q ^ 



g 2 (Xsys) 

J*ys_ 2_1 = ^ T12 _Q2 _V1 = N 
J sys_ 2_2 = Jt12 Q2_V2 + ^T23^Qiyi = N +N 
^sys_2_3 ~ Jt23_Q1V2 ~ ^ 

^sys_ 2_4 = Jt12J22_D1 ~ ^ 

Jsys_ 2_5 = Jt12 _Q2J)2 ~^^T23 _Q1_D1 ~ ^ ^ 

J*ysJ2J> ~ ^ T2 3 jQl _D2 ~ ^ 

Jsys_2_G2 _Q = I 
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gj(Xsys) 



^ sys_3J “ Jt13_Q2_V1 ~ ^ 

J sys _3_2 ~ ^ T23 _Q2_V1 ~ ^ 

J sys_3_3 ~ J 13 JQ_V + J T 1 3 _Q2 V2 ^ T23 jQ2_V2 = 0 + + N 

^sys_ 3_4 = Jt13J)2J)1 ~ ^ 

J sys_3J> ~ ^ T23 jQ2 _D 1 ~ N 

J sys_3J> ~ Jl3J2_D + ^ T 1 3 _Q2 J)2 + ^ T23 _Q2 _D2 = 0 +N +N 



g/tsys) 

Jsys_ 4_1 ~^T12_P1_V1 +Jt13J>1_V1 =N +N 

Jsys_ 4_2 ~ J T12JP1V2 ~ ^ 

Jsys_ 4_3 = Jt13_P1_V2 ” ^ 

^ sys_4~A = ^ T12JP1 _D1 + ^T13_P1_D1 = N +N 
J*ys_4J> ~ J T12_P1 JD2 ~ N 
Jsys_AJ> ~ J T 13 _P1_D2 ~ ^ 

^ sys_4jGl _P ~ I 
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gs(x,,*) 

Jsys_ 5J ~ J T12_P2_V1 ~ ^ 

J *ys_S_2 “ J T12_P2W2 + J T23J>1_V1 = N +N 
Jsys_SJ> ~ J T23JIV2 ~ ^ 

J sys_5_A ~ J T 1 2 _P2 _D 1 ~ ^ 

^sys_ 5_5 = J G2_P_D + ^ T12_P2_D2 ^^T23_P1_D1 = 0 + N + N 
J sys _S_6 ~ J T23 _P1 _D2 ~ ^ 

J sys_G2 _Q = J G2_P _Q~^ 

g^sys) 

^sysjSJ = ^ T 1 3 _P2 _V 1 = N 
J sysjbj. ~ Jt23_P2_V1 = ^ 

J sys_6_3 = J L3_P _V + J TJ3_P2_V2 + ^ T23_P2_V2 = 0 + N + N 
^sysjSy ~ ^ T13 _P2 _Dl = ^ 

Jsys_6_S = Jt23_P2_D1 ~ ^ 

^sysj 6_6 “ J L3_P_D + ^ T13 _P2 _D2 + ^T23_P2_D2 = 0+N +N 
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Sl_Gl_\i X sys) 

^ sys_Gl_V_\ ~ I 

J sys_GlV_Gl_Q = G1_V_£ ~ 

J sysjny_Gl_P - -Jgi_v_p - 

82 , G2 _v( X sys) 
Jsys_G2_V_2 ~ I 

J sys_G2_VJ> ~ G2_V_D ~ ® 

J sys_G2_V_G2_Q “ ~^G2_V_Q ~ 

&4_GlJ)( X sys ) 

^ sys_Gl _D_ 4 I 

J sysjGlJ)_Gl_Q ~ - J G1_D J2 ~ 
J sysJGl J)_G1_P ~ ~Jg1_D_P ~ 



0 

0 

! 

0 

0 

0 
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By applying the rules of Structural Jacobian element arithmetic on the system 
equations, we can generate the following system Structural Jacobian: 



~N 


N 


N 


N 


N 


N 


I 


0 


0 


N 


N 


N 


N 


N 


N 


0 


0 


I 


N 


N 


N 


N 


N 


N 


0 


0 


0 


N 


N 


N 


N 


N 


N 


0 


/ 


0 


N 


N 


N 


N 


N 


N 


0 


0 


0 


N 


N 


N 


N 


N 


N 


0 


0 


0 


I 


0 


0 


0 


0 


0 


0 


0 


0 


0 


I 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


I 


0 


0 


0 


0 


0 



Close inspection of this matrix reveals seven blocks: Six lxl element blocks and one 
3x3 element block: 

Block 1 

System Row: 7 

System Column: 1 

System Variable: V, 

Equations: 

8 1 _Gl_v( X sys) = V\ ~ X Gl_V_nep 

Structural Jacobian: 



J B1 = [n 
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Block 2 



System Row: 


8 




System Columns: 


2 




System Variable: 


V 2 




Equations: 




82_G2J'( X sys) ~ ^ 2 ~ 


Structural Jacobian: 




J B2 = [/] 






Block 3 


System Row: 


9 




System Column: 


4 




System Variable: 


K 




Equations: 




8i_GlJ>( X sys) = V t ~ 


Structural Jacobian: 







j B3 = in 
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Block 4 



System Rows: 3 5 6 

System Columns: 3 5 6 

System Variables: V 3 V s V 6 

Equations: 

8i( X syj) = X L3_Q_nef + X T13 _Q2_r, vf + X T23_Q2_nef 
8s( X sys) = X G2_P _nef + X T12J>2_n*f + X T23_Pl_ruf 
8e( X sys) = X L3_P_nef X T13_P2_nef + X T23_P2_n*f 



Structural Jacobian: 



System Row: 1 

System Column: 7 

System Variable: I GIJi 

Equations: 





'N 


N 


N' 


!! 

>»■ 


N 


N 


N 




. N 


N 


N_ 



Block 5 



8\( X sys) ~ I G1 _Q + X T12J21_ru:f + X T13J)l_r*f 



Structural Jacobian: 



Jbs = [/] 
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Block 6 



System Row: 2 

System Column: 8 

System Variable: Igijp 
Equations: 

Sl( X sys) ~ I G2_Q + X T12_Q2_n*f + X T23 _Q1 _nef 

Structural Jacobian: 

J B6 = U) 

Block 7 

System Row: 4 

System Column: 9 

System Variable: I G2J2 

Equations: 

&(**,) = I G1_P X T12_PI _nef^ X T13_Pl_nef 

Structural Jacobian: 

J B 7 = [/] 
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C-2.5: Solving the System 



Applying the equations for the first three blocks yields: 



^1 = fci V rup 

\ 


1 1 

0 o 

1 1 

v > 


\ 

= 1.0 

/ 


PU 


f 

^2 = fG2 V nev 
. - py 


r \ 

i 1 

0 o 

1 1 


\ 

= 1.05 

/ 


PU 


^ 4 f Gl O _nep | 


f 7 

0 o 

1 1 


\ 

= 0.0 

J 


PU 



Now the following system of three equations for the fourth block must be solved: 



$ 3 4 ’ ^ pre ) 

U*B4,X p re) 

S(k X B4'^ pre) ^ 



= 0 



Where: 







■V," 

Va 

^4 



Starting with the intial guess of [1 0 0] T for x B4 we obtain the following error vector 
and jacobian matrix: 



0.1824 ' 
- 0.4485 
0.5706 



J° = 

J B4 



6.9412 

-0.6176 

1.7253 



0.6176 
4.1176 
- 2.4706 



- 1.7941' 

- 2.4706 
7.1765 
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Inverting the Jacobian and multiplying by the error vector results in the following 
correction vector for x B4 : 




' 0.0441 ' 
- 0.0769 
0.0424 



1 O 0 

x B 4=x B4 -x a 



By repeating the Newton-Raphson iterations several more times, the following table 
can be constructed: 



Iteration 




v 5 


v 6 


g j() 


gsO 


ge() 


0 


1.0000 


00000 


0.0000 


0.1824 


- 0.4485 


0.5706 


1 


0.9559 


0.0769 


-0.0424 


0.0289 


-0.0084 


0.0311 


2 


0.9502 


0.0762 


-0.0463 


2.284e-4 


-0.448e-4 


2.208e-4 


3 


0.9502 


0.0761 


-0.0464 


1.370e-8 


-0.214e-8 


1.240e-8 



From these results, the final three blocks can easily be solved: 

^Gl_Q ~ ~/t 12_Q1 _nef( X T12j) ~ /t13jQ1 

l GlJt = -0.1451 PU 

I G1_P ~ ~/t! 2 _P1 _nef( X T12 J ) — fri3_.Pl _nef( X TlS_i) 

I CI P = -0.1233 PU 

^ G2 J2 = ~fri2_Q2_r K f( X TI2J ) ~ fx23 _Q1 ..nej&nS 

I C2M = -0.2483 PU 
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C-3: Summary of Results 



Bus 1 



Bus Voltage Magnitude 


1.0 PU 




Bus Voltage Angle 


0.0 rad 




G 1 Real/Reactive Power 


-0.1233 PU 


-0.1451 PU 


T12 Real/Reactive Power 


-0.1437 PU 


-0.0423 PU 


T13 Real/Reactive Power 


0.2671 PU 


0.1874 PU 




Bus 2 




Bus Voltage Magnitude 


1.0500 PU 




Bus Voltage Angle 


0.0761 rad 




G2 Real/Reactive Power 


-0.5 PU 


-0.2483 PU 


T12 Real/Reactive Power 


0.1471 PU 


0.0558 PU 


T23 Real/Reactive Power 


0.3529 PU 


0.1925 PU 




Bus 3 




Bus Voltage Magnitude 


0.9502 PU 




Bus Voltage Angle 


-0.0464 rad 




L3 Real/Reactive Power 


0.6000 PU 


0.3000 PU 


T13 Real/Reactive Power 


-0.2617 PU 


-0.1661 PU 


T23 Real/Reactive Power 


-0.3383 PU 


-0.1339 PU 
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Appendix D: Modified Load Flow Example 

Appendix C demonstrated how a system can be built and solved for a conventional 
load flow problem. This example demonstrates how control signals such as real and reactive 
power sharing signals can be incorporated in the load flow solution. In particular, this 
example connects two parallel generators to a load via a transmission line. A conventional 
load flow fails for this example because the generator bus voltage magnitude is 
overdetermined and there is no relationship for sharing reactive power. In this example, 
information variables are used to force each generator to be proportionally loaded and have 
the same power angle. 



Figure D-l: Parallel Generator Load Flow Example 




D-l: Device Definitions 



In addition to the transmission line and PQ load defined in Appendix C, two more 
devices must be defined: A slack bus generator incorporating the load sharing information, 
and a PQ generator employing the load sharing. 
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D- 1.1: VDS Generator (Slack Bus) 
Interface Variables 



Terminal 



Potential Variable Flow Variable (KCL Group) Type 



VQ V (export) Q (import) 

DP D (export) P (import) 

p p (export) 

q q (export) 

The import x imp and export x exp vectors are defined by: 



(0) Nonnal 
(0) Nonnal 
Infonnation 
Information 



x lmp 




m 



x — 

exp 



D 

P 



q 



Parameters 

V G Scheduled Generator Voltage 

D g Scheduled Generator Angle 

P B Scheduled Generator Power Base 

Equations 



V = V/ C 



D=D C 

P 




Device Structural Jacobian 



The device structural jacobian is given by: 



J DS ~ 



0 

0 

0 

N 



O' 

0 

L 

N 
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Device Jacobian 

The device jacobian is given by: 






"0 

0 

0 



p 



0 

0 

J_ 

Pb 

_Q 

p 2 
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D-1.2: PQS Generator 
Interface Variables 



Terminal 


Potential Variable 


Flow Variable 


(KCL Group) Type 


VQ 


V (import) 


Q (export) 


(0) Normal 


DP 


D (import) 


P (export) 


(0) Normal 


P 


p (import) 




Information 


q 


q (import) 




Information 


The import 


and export x exp vectors 
"V 


are defined by: 


rei 



Parameters 

P B Scheduled Generator Power Base 

Equations 



P=~PbP 



Q = ~p bPQ 

Device Structural Jacobian 

The device structural jacobian is given by: 






0 0 N N' 
0 0 L 0 



Device Jacobian 

The device jacobian is given by: 



Jd = 



o 0 -P B q -P B p' 



0 0 -P R 



0 
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D-2: Network Description 



Figure D-2-1 is a block diagram of the system represented in Figure D-l: 
Figure D-2-1: Parallel Generator Example Block Diagram 




D-2.1: Network Specification 

Using the same variable labeling convention as in Appendix C, the devices and 
network are specified by: 

VDS Generator G1 



Terminal 

VQ 

DP 

P 

q 

Parameters: 



Potential Variable 

X Gl_V_nep 
X Gl_D_ntp 
X G1 _pj*p 
X Gl_q_iep 



Flow Variable 

X G1 Q nif 
X Gl_P_nif 



V G 1.05 PU 

D c 0.00 rad 

P B 1.00 PU 

Import Vector: 



X Gl _Q_mf 




h'.i g 


_ X G1 




Jgij>_ 



Node 

1 

3 

5 

6 
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PQS Generator G2 



Tenninal 


Potential Variable 


Flow Variable 


VQ 


X G2_\ 7 _nip 


X C.l_Q_nef 


DP 


X G2J)_nip 


X C,l_r nej 


P 


X G2 




q 


X G2_q_iip 





Parameters: 



Node 

1 

3 

5 

6 



P B 0.50 PU 

Import Vector: 



X G2_V_nip 




'y,' 


X G2_0_ni P 






X G2 _p _}ip 




y 5 


X G2_q_iip 




— i 
i 



Transmission Line T12 



Terminal 



Potential Variable 



Flow Variable 



Node 



VQl 


X T12_Vl_nip 


X T12_Ql_nef 


DPI 


X T12_Dl_nip 


X T12_Pl_nef 


VQ2 

DP2 

Parameters: 


X TJ2_V2_nip 


X T12 _Q2_nef 


X T12_D2_nip 


X T 12 _P 2 jnef 



1 

3 

2 

4 



R 0.05 PU 

X 0.20 PU 



Import Vector: 



X T12\l_nlp 




~v; 


X TJ2_Pl_nip 




v* 


X TJ2J r 2__ni P 






_ X T12J)2_nip_ 




1 

1 
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PQ Load L3 

Terminal 



Potential Variable 



Flow Variable 



Node 



V Q X U_V_nip 

DP X U_D_nip 

Parameters: 

P L 0.60 PU 

Q l 0.10 PU 

Import Vector: 



X L3_Q_ntf 

X U_P_nef 



2 

4 



K L3 



X U_V_nip 
X L3 _D _nip 
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D-2.2: System Variables and Equations 

There are eight system variables and equations associated with this example. There 
are the six node potentials plus two import flow variables ordered in the following manner: 

^ = [E, V 2 i gim I gi J 

The eight system equations are composed of four Kirchhoff Current Law equations 
and four potential equations: 

8 i( X tys) - IgiJ2 + X G2J2.ruf^ X T12_Ql_ruf 
8 l( X sys ) = X L3 _Q_nef + X T12 jQ2_nef 
8 i( X sys) ~ I G1 _P + X G2_P_ncf + X T12_P1 _nef 
8 *( X sys) = X L3_P_nef + X T12_P2_rurf 
8\_Gl_v( X sys ) = E) ~ X Giy_nep 
S3 G 1 _D sys 1 ^ 3 X Gl_D_nep 

§5 _G1 _p ( X sys ) = ^5 _ X G1 _p_iep 
8&JG1 _q( X sys) ^6 X G1 _qjep 
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D-2.3: System Structural Jacobian Matrix 

Using the device structural jacobian matrices along with the system equations, the 
following system structural jacobian can be created: 



~N 


N 


N 


N 


N 


N 


1 


0 


N 


N 


N 


N 


0 


0 


0 


0 


N 


N 


N 


N 


L 


0 


0 


1 


N 


N 


N 


N 


0 


0 


0 


0 


I 


0 


0 


0 


0 


0 


0 


0 


0 


0 


I 


0 


0 


0 


0 


0 


0 


0 


0 


0 


I 


0 


0 


L 


_0 


0 


0 


0 


0 


I 


N 


N 



Applying the system reduction algorithms, five blocks can be identified: two lxl 
element blocks and three 2x2 element blocks: 

Block 1 

System Row: 5 

System Column: 1 

System Variable: V, 

Equation: 

£l _GI_v( X sys) = ^1 ~ X Gl_V_rwp 

Structural Jacobian: 



hi = m 
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Block 2 



System Row: 6 

System Column: 3 

System Variable: V 3 

Equation: 

Structural Jacobian: 



S3_G] J> i. X sys) _ ^ 3 X Gl_D_ntp 



J B 2 = [/] 



Block 3 



System Rows: 2 4 

System Columns: 2 4 

System Variables: V 2 V 4 

Equations: 

&2\ X sys) ~ X U _Q_nef "b X T12 _Q2_nef 
8i( x sys) = X L3_P_nef + X T12_P2,nef 

Structural Jacobian: 



— 



N 

N 



N~ 

N 
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Block 4 



System Rows: 3 7 

System Columns: 5 8 

System Variables: V 5 I GI P 

Equations: 

8l( X sys) = Ig1_P + X G2_P_nef + X T 12 _Pl_nef 
8s_Gl _p(. X sys ) ^5 X G 1 _pjep 



Structural Jacobian: 



Jb4 ~ 



~L 

I 



I 

L 



Block 5 

System Rows: 1 8 

System Columns: 6 7 

System Variables: V 6 I C1J2 

Equations: 

8i( X sys) = I G1 ^Q + X G2 _Q_nef + X T12 _Q1 _nzj 
86JG1 _q( X sys' ^ 6 X Gl_q tt-p 



Structural Jacobian: 






~N 

I 



I 

N 
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D-2.4: Solving the System 



Applying the equations for the first two blocks yields: 

= 1.05 PU 

= 0.0 rad 



/ 

^1 ~ fci V nep 

\ 


'■°1 > 

._oJJ 


ii 

cT» 

1 

4 


rr°H 

ILoJJ 



The remaining blocks are systems of 2x2 equations and unknowns. Blocks 3 and 5 
are nonlinear and must be solved iteratively. Block 4 is linear block requiring only one 
iteration: 

Block 3: 



n 


v, 


V 4 


feO 


8*0 ] 


0 


1.0000 


a .0000 


-0.1353 


0.5414 


1 


1.0000 


-0.1095 


0.0293 


0.0085 


2 


0.9933 


-0.1 §95 


2.017e-4 


0.841e-4 


3 

— 


0.9933 


-0.1105 


1 .046e-8 


0.569e-8 



Block 4: 



n 


V,” " 


I G1_P 


8 ,0 


8gi j>0 


0 


t.0000 


1.0000 


1.1188 


2.0000 


1 

— 


0.4125 


-0.4125 


0.0000 


0.0000 



Block 5: 



n 


V, 


*G1_Q 


fiO 


^GlqO 


0 


0.0000 


a. 0000 


0.1750 


0.0000 


1 


0.2828 


-0.1167 


0.000e-8 


-0.000e-8 
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D-3: Summary of Results 



Bus 1 



Bus Voltage Magnitude 


1.05 PU 




Bus Voltage Angle 


0.00 rad 




G1 Real/Reactive Power 


-0.4125 PU 


-0.1167 PU 


G2 Real/Reactive Power 


-0.2063 PU 


-0.0583 PU 


T12 Real/Reactive Power 


0.6188 PU 


0.1750 PU 




Bus 2 




Bus Voltage Magnitude 


0.9933 PU 




Bus Voltage Angle 


-0.1 105 rad 




L3 Real/Reactive Power 


0.6000 PU 


0.1000 PU 


T12 Real/Reactive Power 


-0.6000 PU 


-0.1000 PU 



Information Node 5 (p ) 
Magnitude 0.4125 

Information Node 6 ( q ) 
Magnitude 0.2828 
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Appendix E: Waveform Examples 
E-l Examples of Waveform Types 

While the possibilities of waveform definitions is endless, this thesis will concentrate 
on the following waveform types: 



Waveform Type 


Code | 


Undefined 


0 


Data Series 


1 


Fourier Series 


2 


Legendre Series 


3 


Polynomials 


3 


Matlab Polynomials 


5 


Chebyshev Series 


6 



The code in the above table refers to the value of the type element in the waveform 
structure. 

E-l.l Data Series 

A data series consists of n equally spaced samples of the waveform stored in an array 
of double precision floating point numbers. The first coefficient is associated with the 
value of the waveform at the beginning of the time interval and the last coefficient is 
associated with the value of the waveform at the end of the time interval. Each element of 
the array is given by: 

c,- =m 

1-1 , 

'/ = 'o + — -j('i-'o) 

/ = 1,2, ...,n 

A data series representation is primarily used for plotting the time history of 
variables and for calculating waveform operators which would prove difficult with other 
waveform types. 
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E-1.2 Polynomial Expansion 



A polynomial expansion consists of n coefficients of a polynomial representation of 
the waveform normalized over the interval [-1 1 ]. 



fix) = I CjX 



;-i 



* = -l +2- 



o 

[,~tn 



Polynomial expansions are useful for evaluating switching operators described 
above. 

A Matlab Polynomial expansion is expressed in descending order: 

fix) = £ c-x n ~‘ 

i = 1 



E-1.3 Orthogonal Function Series 

Orthogonal Function Series can be an excellent means for representing waveforms. 
In an orthogonal series representation, the value of the coefficient of a given order of the 
characteristic function is independent of the number of terms in the orthogonal series. This 
means truncating an orthogonal series by eliminating higher order coefficients will still 
result in the best possible fit with the remaining coefficients. 

In general, an orthogonal series representation is of the form: 

fix) = t c,F,_,(x) 

i' = l 

* e [x 0 A',] 

where F,(x) is the ;th order characteristic function of the orthogonal function series 
with respect to the weighting function r(x). These characteristic functions observe the 
following property: 
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J >'(x)F m (x)F„(x)dx = 0 for m * n 
x 0 

X \ 

jr(x)FJx)F m (x)dx = G(m) 

X 0 

With this property, the coefficients c, of the series can be found: 

x i 

c ‘ = o(hT)f rWMF <- Mdx 

*0 



E-l.3.1 Fourier Series 

Perhaps the most widely used orthogonal function series is the Fourier Series. 
Unfortunately, the Fourier Series is unsuitable for dynamic simulations. To see why, one 
need only look at the manner in which a function is expressed in a Fourier Series: 

n n 

f(x) = Aq + X A, cos(/7U') + Z B ; sin(/‘ tlv) 

i = 1 i«l 



x = -1+2- 



t-to 

t\—t o 



Notice that at x = 1 and x = -1 sin(nur) = 0 and cos(inx) = (-1)' . Consequently 
f(l) = f(-l). In other words, the starting value and ending value of any waveform 
represented by a fourier series is forced to be identical. In dynamic simulations however, 
we often have equations of the form: 






This equation is normally evaluated by integration: 



y = y 0 +\ ^,x)dx 
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where y 0 is the value of the waveform y at the beginning of the interval. If j is 
represented by a Fourier Series, then y evaluated at the end of the interval will also be y 0 . 
In other words, while the value of a state variable may change within the interior of a 
time interval, at the boundaries, the value is constrained to be a constant independent of 
the length of the time interval. This constraint is artificial and not a property of real 
physical systems. 

E-l.3.2 Legendre Series 

Legendre Series use legendre polynomials to form the basis of an orthogonal 
function series over the interval [-1 1]. Legendre polynomials L/x) of order i are defined 
by the following equations: 

U;(X) 

L:(x )= — — for i even 

«;( 1 ) 

v,(a) 

L '(*) = 7m for ‘ odd 

, , , /(» + 1) 2 , i(/-2)(/ + l)(/ + 3) 4 /(/ - 2) (/ - 4) (/ + 1 ) (/ + 3) (i + 5) 6 , 

U ‘ (X)=1 2! X + 4! A ' 6! ^ + • 



(i - 1)0’ + 2) 3 , (i-1)(i-3)(i+2)(i+4) 5 

V;(x)=X — X + — X 



3! 



5! 



(f-l)(f-3)(/-5)(t+2)(/+4)(/+6) 7 + 

7! "■ 



The first six Legendre polynomials are readily found to be: 

L 0 (x)=l 

L } (x)=x 



Liix) = \{ 3x 2 -1) 
l 3 (*) = ^( 5 * 3 - 3; 0 
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Uv) = ^(35a- 4 -30a- 2 + 3) 

O 

L 5 (a) = ^(63a 5 -70a 3 + 15a) 

O 



Legendre Series also obey the following recursion formula 
{n + \)L n + [(a) = (In + 1 )xL n (x ) - nL„ _ ,(a) 

An 77th order legendre series representation of a waveform is given by: 

/(*)= £ c , L ;_ ,(a) 

/ = i 



where: 



A 0 — 1 

*1 = 1 
r(A) = 1 



F i (x)=L i (x) 



0(/) = 



2 

2 / + 1 



The time interval M/l can be mapped to the interval [-1 1] with the following 
transformation: 



A = -l +2- 



t-t. 



h~t o 



The coefficients c, can be found by integration: 



2 / - 1 



c.- = - 



1 

J” f( x )F;^i(x)dX 



E-l.3.3 Chebyshev Series 

Chebyshev Series use Chebyshev polynomials to form the basis of an orthogonal 
function series over the interval [-1 1 ]. Chebyshev polynomials T t (x) of order i are 
defined by the following equations: 
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T 0 (x)= 1 
Ux)=x 

T i + i ( X ) = 2xT i (x)-T l _ l (x) for />! 



The following three Chebyshev polynomials are given by: 

T 2 (x) = lx 2 - 1 

T 3 (x) = 4a: 3 - 3x 



T t (x) = 8.v 4 - 8 a 2 + 1 

An wth order Chebyshev Series representation of a waveform is given by: 

fix)=ic i T i _ i (x) 

i=l 



where 



A 0 — 1 



*1 = 1 



the weighting function r(x) is given by: 



r(x) = 



Vl -a : 2 



and: 



/\(*) = W 
G(0) = jc 

G (w) = ^ for m > 0 
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E-2 Waveform Conversions 



This section describes how to convert a waveform consisting of a vector of 
coefficients of order n 2 to a wavefonn of possibly a different type composed of a vector of 
coefficients of another order n 2 . In all cases, the conversion is a linear matrix operator. 
Hence for given values of rt 2 and rt 2 , the conversion matrix need only be calculated once. 

From here on, L,(x) refers to a vector containing the polynomial coefficients of the tth 
order Legendre Polynomial. L^Xj) refers to the ith order Legendre Polynomial evaluated at 
x r Likewise, T t (x) refers to a vector containing the polynomial coefficients of the ith order 
Chebyshev Polynomial. T^xJ) refers to the tth order Chebyshev Polynomial evaluated at Xj. 

E-2.1 Legendre Series 

a data series of order n 2 requires the 

Li, - i(-*o) 

••• L,-i(*i) 

••• L,-i(^) 



••• L,- iCvi) 

‘ ~n 2 -i 

If C, is the vector of the Legendre Series coefficients and C d is the vector of data 
series points, the following relation holds: 

E-2.1.2 Legendre Series to Legendre Series 

Converting a Legendre Series of order n 2 to order n 2 requires only the truncation of 
terms if n 2 > n 2 or the insertion of zeros in the higher order terms if n 2 < rt 2 . 



E-2.1. 1 Legendre Series to Data Series 

Converting a Legendre Series of order n 2 to 
construction of the following matrix: 



A ld — 



1 


f i(-T>) 




1 


LM ,) 


L 2 (x ,) 


1 


L x {x 2 ) 


L 2 (x^) 



1 - 1 ) 



_ 1 I o 
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E-2.1.3 Legendre Series to Chebyshev Series 



Converting a Legendre Series of order n, to a Chebyshev Series of order n 2 first 
requires the truncation or padding with zeros of the Legendre series to order n 2 . The 
resulting Legendre Series should then be multiplied by the following upper trianglular 
matrix: 



Alt ~ Aj A L 

A l = [^o( A ) ) ••• Lij -](-*■)] 

A t = [ T 0 (x) T,(x) T 2 (x) ... 7^,00] 

where L t (x) is a vector of order n 2 holding the polynomial coefficients of the /th order 
Legendre Polynomial and T,{x ) is a vector of order n 2 holding the polynomial coefficients 
of the /th order Chebyshev Polynomial. 

E-2.1.4 Legendre Series to Polynomial Expansion 

Converting a Legendre Series of order n 2 to a polynomial expansion of order n 2 first 
requires the truncation or padding with zeros of the Legendre series to order n 2 . The 
resulting Legendre Series vector should then be multiplied by the following upper 
triangular matrix: 

A l = [L 0 {x) L,(x) L 2 (x ) ... 

where L,(x) is a vector of order n 2 holding the polynomial coefficients of the /th order 
Legendre Polynomial. 
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E-2.2 Chebyshev Series 
E-2.2.1 Chebyshev Series to Data Series 



Converting a Chebyshev Series of order n, to a data series of order n 2 requires the 
construction of the following matrix: 





‘1 


Ux o) 


T 2 (x 0 ) 


T’-.-.C* o) 




1 


w 


TM .. 


• T^ix ,) 




1 


n x 2 ) 


T 2 (x 2 ) .. 




^TD — 


• 


• 


• 






1 






-\(Xn 2 - 1 



If C, is the vector of the Chebyshev Series coefficients and C d is the vector of data 
series points, the following relation holds: 

C d ~ A tdC, 



E-2.2.2 Chebyshev Series to Legendre Series 

Converting a Chebyshev Series of order n l to a Legendre Series of order n 2 first 
requires the truncation or padding with zeros of the Chebyshev series to order n 2 . The 
resulting Chebyshev Series should then be multiplied by the following upper trianglular 
matrix: 



A u — A L A t 

A l = [L q (x ) L , ! (.v ) L 2 (x) ... 1 (^)] 

A t =[T 0 ( X) T,(x) T 2 { x) ... T„ 2 _,( a)] 

where L,{x ) is a vector of order n 2 holding the polynomial coefficients of the /th order 
Legendre Polynomial and T,(x ) is a vector of order n 2 holding the polynomial coefficients 
of the /th order Chebyshev Polynomial. 
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E-2.2.3 Chebyshev Series to Chebyshev Series 

Converting a Chebyshev Series of order n, to order n 2 requires only the truncation 
of terms if n l > n 2 or the insertion of zeros in the higher order terms if n , < n 2 . 

E-2.2.4 Chebyshev Series to Polynomial Expansion 

Converting a Chebyshev Series of order n 2 to a polynomial expansion of order n 2 
first requires the truncation or padding with zeros of the Chebyshev series to order n 2 . 
The resulting Chebyshev Series vector should then be multiplied by the following upper 
triangular matrix: 

A t = [T 0 (x) 7,0) T 2 (x) ... 

where 7,(x) is a vector of order n 2 holding the polynomial coefficients of the /th order 
Chebyshev Polynomial. 
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E-2.3 Polynomial Expansion 
E-2.3.1 Polynomial Expansion to Data Series 



Converting a polynomial expansion of order n, to a data series of order tt 2 requires 
the construction of the following matrix: 




1 




^ 2-1 



X: = “I 



+ 



2 



i 

n 2 - 1 



If C p is the vector of the polynomial coefficients and C d is the vector of data series 
points, the following relation holds: 

= A PD C p 

E-2.3.2 Polynomial Expansion to Legendre Series 

Converting a polynomial expansion of order n t to a Legendre Series of order n 2 
requires first converting to a Legendre series of order n 2 then converting the Legendre 
Series to order n 2 . Recall that the matrix for converting from a Legendre Series to a 
Polynomial is upper triangular. Hence one only needs to use backward substitution to 
solve for the Legendre Series coefficients: 

A L = \C oCO f i (x ) ... 1(-0] 



c p = a l c, 

E-2.3.3 Polynomial Expansion to Chebyshev Series 

Converting a polynomial expansion of order n, to a Chebyshev Series of order n 2 
requires first converting to a Chebyshev series of order n 2 then converting the Chebyshev 
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Series to order n 2 . Recall that the matrix for converting from a Chebyshev Series to a 
Polynomial is upper triangular. Hence one only needs to use backward substitution to 
solve for the Chebyshev Series coefficients: 

A t = [T 0 (x) T,( x) T 2 (x) ... 

c p = a t c, 

E-2.3.4 Polynomial Expansion to Polynomial Expansion 

Converting a polynomial expansion to another polynomial expansion of higher 
order only requires setting the higher order tenns to zero. Converting to a lower number 
of teirns requires more effort. The best method is to convert to an orthogonal function 
series, truncate, and convert back. Since all of these operations are linear matrix 
operations, the conversion matrix need only be calculated once. For this conversion, 
either the Legendre Series or the Chebyshev series would be appropriate since the type 
conversions to and from the series solution does not add any truncation error (The 
truncation error is solely due to the truncation of the Legendre Series or Chebyshev series 
and not due to the conversions). 
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E-2.4 Data Series 



E-2.4.1 Data Series to Data Series 

There are many methods for converting a data series to another data series with a 
different number of coefficients. Two common interpolation schemes for performing this 
conversion are linear interpolation and cubic splines. These methods can be found in 
many numerical methods textbooks and will not be described here. 

E-2.4.2 Data Series to Legendre Series 

If tij > rt 2 , a Data Series can be converted to a Legendre Series by taking the 
pseudo-inverse of the matrix converting a Legendre Series to a Data Series. If n 1 < n 2 , the 
Data Series can be converted in a similar manner to a Legendre Series of order padded 
with zeros to order n 2 . 





' 1 LM 




■■ Vi(*o) ‘ 




1 £,(*,) 


L 2 (x,) 




A/J) — 


1 L,(^) 


L 2 (a 2 ) 


- 




1 £i(*„,-i) 







If C d is the vector of data series points and C, is the vector of Legendre Series 
Coefficients, the following relation holds: 

= Au)Ci 



C i — (Ald^ld) 



E-2.4.3 Data Series to Chebyshev Series 

Converting a Data Series to a Chebyshev Series can be done in the same manner as 
the conversion to a Legendre Series: 
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1 7> 0 ) 


T 2 (x 0 ) 


1 

, O 

i 


1 Uxj) 


T 2 ( x,) ... 




1 T,(x 2 ) 


T 2 (x 2 ) ... 


T,ax 2 ) 


1 Ux^) 






x,= 


- 1 +2 l — 
n , - 1 





If Cj is the vector of data series points and C c is the vector of Chebyshev Series 
Coefficients, the following relation holds: 

Cj ~ AtdC c 

Cc = (Aj-pAj-p) AjpCj 

E-2.4.4 Data Series to Polynomial Expansion 

Converting a data series to a polynomial expansion of equal or less order using a 
least squares fit is a straight forward process. If the number of points in the data series n x 
is equal to or less than the number of points in the polynomial n 2 , the resulting 
polynomial will pass through each point of the data series. If larger, the polynomial will 
not necessarily pass through all of the data series points, but will be a least square 
approximation. 

For ft j < n 2 : 

For this case, the problem is to solve for the coefficients of the polynomial c pi for 
i < rtj. For the higher coefficients (i > rtj), c pi = 0. In the following discussion, let C d be 
the vector of rtj data series coefficients and C p be the vector containing the first rtj 
polynomial coefficients. Define the rtj x n 2 matrix A as follows: 
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1 X, X 



.2 



x 






X; =- 1+2 



Matrix A PD is square, clearly has rank and therefore is invertible. Consequently 
solving for C p is straight forward: 



For ttj > n 2 : 

If the number of data points is greater than the number of polynomials, the number 
of columns in the A PD matrix described above would have n 2 columns and n 2 rows. A PD 
would clearly not be invertible. The pseudo-inverse of A PD can be calculated and 
provides the least squares fit of the data series: 
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E-3 Waveform Arithmetic 



This section describes how to perform addition, subtraction, multiplication, and 
division on the various types of waveforms. 

E-3.1 Data Series 

Performing waveform arithmetic on data series is very easy. The waveforms are 
converted to the proper size and then added, subtracted, multiplied or divided element by 
element. 

E-3.2 Polynomials 
E-3.2.1 Addition/Subtraction 

Adding or subtracting two polynomial waveforms simply entails converting the two 
waveforms to the proper length and adding or subtracting element by element. 

E-3.2.2 Multiplication 

Multiplying polynomial wavefonn tV of size n w and Y of size n y together to get 
polynomial Z of size n w + n y - 1 can be accomplished by constructing the following 

y, o o o ... o o' 

y 2 y, o o ... o o 

y 3 y 2 y, o ... o o 

y 4 y 3 y 2 y, ... o o 



o o o o ... y„ y„ . 
o o o o ... o y n> 

z = M p W 

Z can now be truncated or padded with zeros to convert it to the proper length. The 
truncation of a polynomial is discussed in section E-2.3.4. 



matrix of size n w + n - 1 x /»„ 



M p = 
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E-3.2.3 Division 



Dividing two polynomial expansions can be difficult, particularly if the 
denominator polynomial has one or more zero crossings. In general, there is no simple 
method for performing the division, although the recursion process described in this 
section will work. Define the problem to be: 



X Y iX ‘- 



% 

X Bpc’-' 

J = * 

X C*v* -1 

* = i 



There are two parts to the problem. The first task is to use synthetic division until 
the numerator of the remainder is of size n c -1 or less. The second task is to convert the 
remaining fraction into another polynomial expansion by a process similar to synthetic 
division, but proceeding from the constant term and working up in order. 

Synthetic division is the process of dividing one polynomial by another until the 
remainder is of order 1 less than the denominator. 



.'-i 



X d/X j jl. ' / 



/ = ! 



/ r " c + — 



X r,x‘ 1 



X c** 

k = 1 



k - 1 



X CtX 

k = 1 



k - 1 



r t = d r 



Initially, d t is set equal to After the first iteration, d , is set equal to the remainder 
r,. The process is repeated until n d -n c - 1. At this point, the direction of the division is 
reversed and we get: 

n d n d “ * 

X4*'- 1 , Inx 1 -' 

l = 1 u \ / = 1 

= h X 

C, 

Xc/- Xv*“ 

k = 1 k = 1 
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r 



i - \ 



=d- 



d, 




In this manner, we can express the remaining fraction as another polynomial 
expansion. The actual values for T, are equal to the sum of the components from the 
forward and backwards synthetic division. 

Note that if the denominator has a zero over the interval [- 1 , 1 ], the backwards 
synthetic division will result in a diverging series. 
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E-3.3 Legendre Series 
E-3.3.1 Addition/Subtraction 

Adding or subtracting two Legendre Series waveforms simply entails converting the 
two wavefonris to the proper length and adding or subtracting element by element. 

E-3.3.2 Multiplication 

Multiplying two Legendre Series together can be accomplished in two ways. The 
first way is to convert the Legendre Series to polynomial expansions, multiply the two 
together, then convert the product to the Legendre Series of the proper size. The second 
method uses the recursion formula for the Legendre series to assist in the process: 

To multiply Legendre Series Y of size n y by the Legendre Series W of size n w to 
obtain the Legendre Series Z of size n. = n y + n w - 1, Y must first be convened to a 
polynomial expansion Y p of size n y . 



which can be translated into the following matrix for multiplying a given Legendre 
Series of size n z by x : 



A L = [K( X ) L^x) L 2 (x) ... L„ v _,(»] 




The recursion fonnula for the Legendre Series is given by: 
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0 



0 



1 

0 

0 



1 

3 

0 

2 

3 

0 



0 0 



- 0 



o - 



- 0 



A 



XL ~ 



0 

0 

0 

0 



0 

0 

0 



0 0 0 0 
0 0 0 0 
0 0 0 0 



n : - 2 

2(/j. - 2) + 1 

n. - 1 

0 

2(« t -l) + l 

n. - 1 

0 

2 (n. - 2) + 1 



If we define the vector to be Y p padded with zeros such that it is of size n z , we 
can define the following n z x n u . matrix: 

A mp i - [ Y pl A xl Y pI A XL A XL Y pl ... A^ Y p j\ 



The final n z x n w multiplication matrix A ml , can now be found: 

A m u = A mp Ai 



Z=A mll W 



Of course Z may have to be truncated or padded with zeros to convert it to the 
desired length. 

E-3.3.3 Division 



There is no straight forward method for dividing two legendre series. The easiest 
way appears to be converting to polynomial expansions, performing the divison, then 
converting back to the legendre series. 
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E-3.4 Chebyshev Series 
E-3.4.1 Addition/Subtraction 

Adding or subtracting two Chebyshev Series waveforms simply entails converting 
the two waveforms to the proper length and adding or subtracting element by element. 

E-3.4.2 Multiplication 

Multiplying two Chebyshev Series together can be accomplished in two ways. The 
first way is to convert the Chebyshev Series to polynomial expansions, multiply the two 
together, then convert the product to the Chebyshev Series of the proper size. The second 
and preferred method uses an alternate definition of a Chebyshev Polynomial to assist in 
the process: 

T n (x) = cos(« cos”’(x)) 

T^x) = T n ( x) 

From this definition, the product of two Chebyshev Polynomials can easily be 
derived: 



T n (x)T m (x) = cos (n cos '(x))cos (m cos ’(jc)) 

T n (x)T m (x) = ^(cos((n +m)cos~\x)) + cos((n -m)cos~\x))) 

T n {x)T m {x) = \{T n , m {x) + T n _ m {x)) 

To multiply Chebyshev Series Y of size n y by the Chebyshev Series W of size n H . to 
obtain the Chebyshev Series Z of size n z - n y + n w - 1, three n z x n w matrices should first 
be constructed: 
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'y, o o ... o o 

y 2 y , o ... o o 

y 3 y 2 y, ... o o 






mil 



0 0 0... ^ y„ x _, 

o o o ... o 



— 



y, y 2 y 3 

^ r, r 4 

K y 5 



'0 o 

0 Y, 
0 0 



0 0 ... 

y 2 y 3 ... 

y, y 2 ... 

o y, ... 



The final n z x n w multiplication matrix A ^ is given by: 

A mn - 2 ( A nul + A m,2 + A m,s) 



Z=AW 
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Of course Z may have to be truncated or padded with zeros to convert it to the 
desired length. 

E-3.4.3 Division 

There is no straight forward method for dividing two chebyshev series. The easiest 
way appears to be converting to polynomial expansions, performing the divison, then 
converting back to the chebyshev series. 
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E-4 Waveform Functions 



E-4.1 Data Series 

E-4.1.1 Trigonometric and Exponential Functions 

All trigonometric and exponential functions can be performed point by point on the 
data series coefficients. 

E-4.1.2 Integration and Differentiation 

There are a number of techniques for integrating or differentiating Data Series. All 
are by their nature approximations and can suffer from numerical instability problems 
associated with conventional simulations. One simple method of integration employs the 
trapezoidal rule: 



^DD ~ 



0 0 0 0 
h h 



2 

h 

2 

h_ 

2 

h_ 

2 



2 

h 

h 

h 



0 0 

r 0 0 



h 

h 



\ 0 
* \ 



h h h h 

h h h h 

t h h h h 



0 0 0 
0 0 0 

0 0 0 

0 0 0 

0 0 0 



-00 



h 

h 



h 

2 



0 



h - 



h = 



n - 1 



With this matrix, the integral equation: 
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Becomes the matrix operation: 



Y = 




Wdx 



y=s dd w + y 0 

The vector Y may be now converted to a different length if so desired. 

Differentiating a Data series can be done in a number of ways. The secant method 
can be easily implemented with the following matrix: 



A DDJ~ h 



-1 
_ 1 
~ 2 



1 

0 

1 

~2 

0 



0 

1 

2 

0 

1 

~2 



0 0 
0 0 



0 0 0 " 

0 0 0 

0 0 0 

0 0 0 



0 0 0 0 0 
0 0 0 0 0 



1 

2 



0 



0 -1 



1 

2 

1 



h = 



1 

n- 1 



Another approach is to choose a differentiation matrix such that it is consistent with 
the integration matrix. Consistency is defined by the following matrix equation: 

S DD A DD2 = M 



where 
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M = 



' 0 0 0 0 
-110 0 
-10 10 
-10 0 1 



The M matrix reflects the fact that differentiating a data series will destroy the 
subsequent constant of integration. Since Sdd is generally singular, only its 
pseudo-inverse can be taken: 



D 1)1)2 — (S DI ) S DD ) S dd M 



This matrix actually has a very simple construction: 

2n - 3 In -5 In -1 



Ddd2 ~ • 



dn 



d. 



]_ 

n 



]_ 

n 



n 



3 

n 



3 

n 



n 

2n - 5 

n 

d 33 

_5 

n 

5 

n 



n 

2n -7 

n 

2 n -7 

n 

d u 

_ 7 

n 



2 n -9 

n 

2 n -9 

n 

2n — 9 

n 

2/r — 9 

n 

d 55 



is equal to the the negative sum of all the other terms in the xth row. As a 
consequence, all of the row sums of are equal to zero and is singular. 

E-4.1.3 Switching Functions 

All switching functions can be performed point by point on the data series 
coefficients. 
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E-4.1.4 Waveform Smoothing 



There are times when it may be desirable to remove high spectral content features 
of a waveform. One way to do this is to replace the value at each point in the time 
domain by the average of the waveform over some interval [x - A,x + A]. This can be 
accomplished by defining the following: 



/ 

>h = int 

V 

where int(x) is the integer nearest x. 



A(n-l) 



1 


1 


1 


"a 


"a 


«A 


1 


1 


1 


n A + l 


«A+1 


n A +l 


1 


1 


1 


n A + 2 


n A + 2 


n A + 2 



1 


1 


1 


2n A 


2n A 


2n A 


0 


1 

2/? a 


1 

2n A 



1 

«A 


0 


0 


1 


1 


0 


n A + 1 


n A + 1 


1 


1 


1 


«a + 2 


n a + 2 


n a + 2 



1 


1 


1 


2 n A 


2n A 


2n A 


1 


1 


1 


2n A 


2n A 


2n A 



Multiplying a data series by A smlh will return a smoothed version of the data series. 
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E-4.2 Polynomial Expansion 

E-4.2.1 Trigonometric and Exponential Functions 

There is often no direct way of evaluating a trigonometric or expontential function 
of a polynomial expansion. Instead, the function is performed on a data series converted 
from the argument polynomial. The resulting polynomial is then reconverted back into a 
polynomial. 

E-4.2.2 Integration and Differentiation 



Integrating a polynomial Y of size n y results in another polynomial Z of size 
n z = n y + 1. The n z x n y integration matrix $dp is given by: 



$dp ~ 






The integral is evaluated by: 



1 1 
3 4 



10 0 0 

0^00 

2 

0 0 



- 0 



0 0 0 - 



0 0 0 0 
0 0 0 0 



(- 1 ) (- 1 ) 



n y - 1 

0 

0 

0 

0 



n y - 1 



0 



0 

0 

0 

0 



Z — S DP Y + Z 0 



Of course, Z may be converted to a polynomial of a different size if desired. 

Differentiating a polynomial Y of size n y results in another polynomial Z of size 
n z = n y - 1. The n z x tx y differentiation matrix A DP is given by: 
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'0100 
0 0 2 0 
0 0 0 3 



0 0 
0 0 
0 0 



0 0 0 0 
0 0 0 0 



n y - 2 0 

0 n - 1 



The Differential is evaluated by: 



E-4.2.3 Switching Functions 

Switching functions are those which produce a Polynomial waveform Y which is 
composed of m pieces of other Polynomial waveforms. Let fj be the Polynmomial 
representation of the yth piece of Y. Let x 0 (j) be the x coordinate of the ending point of 
the /th piece where x o (0) = -1 and x 0 (m ) = 1. 

Define Y t to be the Legendre Series representation of Y : 




Then using the orthogonality property of the Legendre Series: 




Now define the following row vector: 



l(x 0 (j)) = [fo(-VoO')) £,(.v 0 (/)) L 2 (x 0 (j)) ... L n _,(-VoO')) f.(.VoO'))] 
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With S I)L as defined in section E-4.3.2 and A mp { ) as defined in section E-3.3.2 the 
solution for Y, can easily be found: 



1 

2 

0 




0 

3 

2 

0 



0 

0 

5 

2 



0 

0 

0 



0 0 0 



In - 1 
~ 2 ~ 



Yf = X (/(A'oO)) - Kx 0 (J - 1 )))S DL A mpt {f J )G l 
j - 1 



Now we need only convert Y, to a polynomial exansion Y: 



Y=A L Y, 



where 



A l = [L 0 (x) L y {x) L 2 (x ) ... L n _,(A)] 

E-4.2.4 Waveform Smoothing 



There are times when it may be desirable to remove high spectral content features 
of a wavefonn. One way to do this is to replace the value at each point in the time 
domain by the average of the waveform over some interval [x - A,x + A], This can be 
expressed by the following integral: 



n 



X Y;X 



1-1 



x + A 




WjTf~ l dx 



The only problem with the above equation is near the boundaries x = -1 and x = 1 
where the integration interval has the possibility of crossing the boundaries and including 
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within the average a section of the polynomial outside the defining interval (- 1 , 1 ]. Hence 
the smoothed polynomial should be composed of the following three segments (assuming 
A < 1): 

-1 <a- <-l + A 



x + A 



n 1 C n 



f 'd x 



-1 + A <jc < 1 - A 



x-A 



1 - A < x < 1 



i 

f iw/-'dr 

; = i 1 -x + A J , = i 1 

x-A 



Note, if 1 < A < 2 then the interval boundaries are given by: 

[-1 , 1 - A] 

[1 - A , -1 + A] 

[-1+A , 1] 

If A > 2 then there is only one interval and the average of the waveform is returned: 

i 

Y ,=\j iw/-'dx 

-1 

Y, = 0 for / > 1 



For A < 2 evaluating the integrals require the definition of shifting a waveform left 
or right by A. This can be done by constructing the following binonomial matrix: 
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B 



exp 



11111 
0 12 3 4 

0 0 13 6 

0 0 0 14 

0 0 0 0 1 



This matrix can be generated by the following recursion formula; 

£,x P (i>;) = i 

5 cxp (2:/t,l) = 0 

5 expOJ) = 5 exp - 1) + 5 cxp(i — 1,7 — 1) 



Multiplying B np element by element by the following matrix will give us the 
transformation matrix B shfi for shifting a waveform left by A. 



B 



A 



1 

0 

0 

0 

0 



A A 2 
1 A 
0 1 
0 0 
0 0 



A 3 A 4 . 
A 2 A 3 . 
A A 2 . 
1 A . 
0 1 . 



I M/-' = I Nlx + Ay' 

;=] j~i 

M=B shfi N 



The tools are now all present. W can be integrated using the integration matrix Sdp 
defined in section E-4.2.2. The limits of integration for the three segments can be applied 
by either using B shfi for the limits involving x, or by direct evaluation for those limits not 
involving x. Dividing by the averaging interval comes next. For the first and third 
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intervals, the methods outlined in section E-3.2.3 can be used to divide a polynomial by 
another polynomial. Finally, the procedure for generating Switching Functions described 
in section E-4.2.3 can be used to generate the coefficients for the solution Y. 
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E-4.3 Legendre Series 

E-4.3.1 Trigonometric and Exponential Functions 

There is often no direct way of evaluating a trigonometric or expontential function 
of a Legendre Series. Instead, the function is performed on a data series converted from 
the argument Legendre Series. The resulting polynomial is then reconverted back into a 
Legendre Series. 

E-4.3.2 Integration and Differentiation 

Differentiating a Legendre Series can be done easily by differentiating the recursion 
formula for the Legendre Series. Recall: 

(i + 1)W*) = ( 2 » + ~ 'V»W 



Differentiating: 



d±Ax) 

dx 



2/ + 1 
i + 1 



x 



d^jx) 

dx 



\ 

+ L,(x) 



J 



( i \ d_Lj-M 
v /' + 1 J dx 



where: 



dL o(a-) 



dx 

dL,{x) 



= 0 



dx 



= 1 =L 0 (x) 



The goal is to generate the following n x n matrix: 
dL 0 (x) dL x {x) dL 2 (x) 



^dl ~ 



dx 



dx 



dx 



dL n _ ,(-X~) 

dx 



The columns of A DL can be solved recursively once we define the matrix A XL for 
multiplying a Legendre Series Vector by x. 



xL,{x) = \ 



2 / + 1 






'i + 1 ^ 
2i + 1 



A + 1 (-v) 
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0 



0 



1 

0 

0 



1 

3 

0 

2 

3 

0 



A 



XL — • 



0 0 



- 0 



0 - 



- 0 



0 

0 0 
0 0 



0 



0 



0 0 0 0 
0 0 0 0 
0 0 0 0 



”- 2 0 

2(n - 2) + 1 

0 2^71 

"- 1 0 

2(n - 2) + 1 



Note that the last row of A XL has been elminated to make the matrix square. This 
will not cause any problems since in the recursion formula, the last coefficient of the 
vector multiplying A XL is always zero. 



Let A dl (:J) represent the yth column of A DL . Let / be the n x n identity matrix. The 
recursion fonnula states: 



A DL (:, / + 2) — 



2 / + 1 
V ' + 1 J 



(Axl a dl('-’ / + 1) + /(:,/ + !))- 



i + 1 



A nr, (•> 0 



1 </'<«- 2 

Once A DL is constructed, it can be used to calculate derivatives. Let \V and Y be 
vectors of Legendre Series coefficients of size rt. Then the following statements are 
identical: 




y=a dl w 



Of course, the nth coefficient of Y will always be zero since the nth row (as well as 
the first column) of A DL will always be populated with zeros. 
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Integration is a bit more complex. In general, the problem is to solve the following 
equation: 



First, the n+l x n indefinite integral matrix S lL should be found. The easiest way of 
generating S IL begins by adding an additional column to A DL using the same recursion 
formula to form the n x n+l matrix A DLJ . S IL is simply the pseudo-inverse of A DLJ : 



The next step is to evaluate the integral at x = -1. This can be done by multplying 
the following row vector by S [L : 

*-, = [! -1 1 -1 ... (- 1 )"' 1 ] 



The first row of S lL contains all zeros. If this row is replaced by -5., and the 
resulting matrix called we have all the pieces for calculating the integral of a 
Legendre Series: 



Of course, the vector Y may have to be truncated or padded with zeros as required. 

E-4.3.3 Switching Functions 

Switching functions are those which produce a Legendre Series wavefonn Y which 
is composed of m pieces of other Legendre Series waveforms. Let fj be the legendre 
series representation of the /th piece of Y. Let x 0 (j) be the x coordinate of the ending 
point of the /th piece where jr^O) = -1 and x 0 (m) = 1. 



jr 






Y = S DL W + Y 0 



Let: 
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y = 



Then using the orthogonality property of the Legendre Series: 






2 / - 1 



2 y 



fj(x)L,(x)dx 



* oO'-D' 

Now define the following row vector: 

/(* 0 (/)) = [U*o(/)) £,Oo(/)) ^oO')) ••• L n -i(Xo(j)) k(x 0 m 



With S DL as defined in section E-4.3.2 and A m ,£) as defined in section E-3.3.2 the 
solution for Y can easily be found: 



G,= 



I 0 0 



0 5 0 



0 0 - 



0 0 0 



0 

0 

0 



2/j-l 



Y T = 2 (!(x 0 (j)) - I (x 0 (J - mS^A^G, 

;= i 



E-4.3.4 Waveform Smoothing 

There is no obvious method for performing waveform smoothing in the Legendre 
Series spectral domain. Instead, the waveform should be converted to a polynomial 
expansion and the methods of section E-4.2.4 employed. 
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E-4.4 Chebyshev Series 

E-4.4.1 Trigonometric and Exponential Functions 

There is often no direct way of evaluating a trigonometric or expontential function 
of a Chebyshev Series. Instead, the function is performed on a data series converted from 
the argument Chebyshev Series. The resulting polynomial is then reconverted back into a 
Chebyshev Series. 

E-4.4.2 Integration and Differentiation 

Differentiating a Chebyshev Series can be done easily by differentiating the 
recursion formula for the Chebyshev Polynomials. Recall: 

T i + l (x) = 2xT i (x)-T i _ l (x) 



Differentiating: 



dT l + 1 (x) dT,(x) 

-^T = 2x -dT- 



+ 2T,(x)- 



dT^Qc) 

dx 



where 



dT o(x) _ Q 

dx 

dUx) 

dx 

The goal is to generate the following n x n matrix: 

dT 0 (x) dT x (x) dT 2 (x ) dT n _ x (x) 

A DT = . . . 

dx dx dx dx 

The columns of A DT can be solved recursively once we define matrix A XT for 
multiplying a Chebyshev Series vector by x. 

xTfc) 
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0 



1 

0 

0 



1 

2 

0 

J. 

2 

0 



A 



XT ~ • 



0 0 



- 0 



0 - 



- 0 



0 0 
0 0 
0 0 
0 0 



0 0 0 0 ... ]■ 0 

2 

0 0 0 0 ... 0 \ 

2 

0 0 0 0 ... ^ 0 

2 



Note that the last row of A xr has been eliminated to make the matrix square. This 
will not cause any problems since in the recursion formula which follows, the last 
coefficient of the vector multiplying A XT is always zero. 

Let A DT (:J) represent the /the column of A DT . Let / be the n x n identity matrix. 
The recursion formula states: 



i A 2) — '2A X j-Apj( < '., i + l) + 2/(:,i + l) A D j -{'., /) 



!'</</ 7-2 

Once A dt has been constructed, it can be used to calculate derivatives. Let W and Y 
be vectors of Chebyshev Series coefficient of size n. Then the following statements are 
identical: 



Y 



d\V 

dx 



Y = A dt W 



Of course the nth coefficient of Y will always be zero since the nth row' (as well as 
the first column) of A DT w'ill always be populated w'ith zeros. 
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Integration is a bit more complex. In general, the problem is to solve the following 
equation: 

x 

y = y 0 + J wdx 

x=-l 

First, the /i+l x n indefinite integral matrix S n should be found. The easiest way of 
generating S IT begins by adding an additional column to A DT using the same recursion 
formula to form the n x «+ 1 matrix A DTI . S IT is simply the pseudo-inverse of A Dn : 

Sn = ( A DT jA DT i ) A dti 

The next step is to evaluate the integral at x = -1. This can be done by multplying 
the following row vector by S a : 

*-, = [1 -1 1 -1 ... (- I )""'] 



S. t =X_ t Sn 



The first row of Sn contains all zeros. If this row is replaced by -S. ; and the 
resulting matrix called S DT , we have all the pieces for calculating the integral of a 
Chebyshev Series: 

y = s dt w + y 0 



Of course, the vector Y may have to be truncated or padded with zeros as required. 

E-4.4.3 Switching Functions 



Switching functions for Chebyshev Series can not be evaluated as easily as the 
switching functions for Legendre Series due to the weighting function r(x ) for the 
Chebyshev Polynomials. Recall: 



- =1 [J® 
'-ttJ VTT 



-dx 



c 



m 



2 'r /(A)r m .,( X ) 
71 Vi -x 



The situation is not hopeless due to the following integral equations: 
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f dx • -v X 

)W^ =sm(x) 



/ 




dx = -Vl 



-A' 



.2 



I 



.2m 



Vi- 



„2 



-dx - 



(2m)! 

( m !) 2 






i 

r = 1 



r!(r-l)! | sin '(a) 

2 2m_2r + i(2r)! 2^ 



f^L dx= _^?i 



(2r)!(m!) 2 

r“i(2/w +!)!(;- !) 2 



m —r 2 r 

r x 



Thus if fj is the Chebyshev Series representation of the /th piece of Chebyshev 
Series waveform Y and x 0 (j) is the x coordinate of the ending point of the yth piece, then 
we can state the following: 






Y = 



y 2 

y 3 



x 0 (0) = -1 
x 0 (m)= 1 



y, 




■dx 




f,{x)T m _,{x) 

VT ^ 2 



dx 



Tlie process should now be clear: 

1. Convert fj(x) to a polynomial representation f pj {x ) 
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2. Multiply f PJ (x) by the polynomial representation for T,(x) and call the resulting 

polynomial f tJ {x). 

3. Use the above integral equations to evaluate at x = x 0 (f) and x = x 0 (j- 1) the 

integral of f tJ (x) term by tenn to fonn the /th component of F, called F ^ 

4. Sum up Y p over j to produce F,-. 

WTiile the above process will produce the correct values for F„ the following 
method is much easier to calculate and produces nearly identical results: 

1 . Convert fj(x) to a Legendre Series representation f t) {x) 

2. Calculate the Legendre Series Representation Y, of Y with the methods of section 

E-4.3.3. 

3. Convert Y, to the Chebyshev Series Representation Y. 

E-4.4.4 Waveform Smoothing 

There is no obvious method for performing waveform smoothing in the Chebyshev 
Series spectral domain. Instead, the waveform should be converted to a polynomial 
expansion and the methods of section E-4.2.4 employed. 
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Appendix F: Model Development 



The following electrical power system models have been develped in support of 
WAVESIM: 

Three Phase Synchronous Generator 

Voltage Regulator 

Prime Mover 

Three Phase Switch 

Transmission Line 

Constant Impedance Loads 

Reduction Gear 

Propeller 

Ship Dynamics 

Pulse Generator 

Induction Motor 
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F-l 3 Phase Synchronous Machine Model 



Two models are presented for simulating a three phase synchronous model. The first 
expresses the voltages and currents in terms of a rotating reference frame (dqO) rotating at 
the base frequency. This model is suitable for studies where the voltages and currents are 
balanced, nearly sinusoidal, and near the base frequency. For fast transients or unbalanced 
operations, the actual instantaneous values for the voltages and currents should be used (abc 
frame). Both models are very similar in that the terminal values are transformed to a 
rotating reference frame alligned with the rotor of the machine (Park’s Transformation) 

F-l.l DQO Model 
Interface Variables 



Terminal 

Stator Direct 
Stator Quadrature 
Stator Zero Sequence 

Mechanical 



Field Voltage 



Stator D-axis Current 
Stator Q-axis Current 
Stator 0-axis Current 
Field Current 



Potential Variable Flow Variables (KCL Group) Type 



V D (import) 
V Q (import) 
V 0 (import) 

(import) 

V FD (import) 

/ D j (export) 
/ QI (export) 
hi (export) 
^FI (export) 



7 D (export) 
/ Q (export) 
I 0 (export) 

T m (export) 



( 1 ) Normal 
(1) Normal 
(1) Normal 

(0) Normal 

Information 

Information 

Information 

Information 

Information 



The import x ^ and export x vectors are defined by: 



AT- = 

imp 



V D 

v q 

Vo 

V FD 

co„ 






'o 

h 

T m 

?DI 

l Ql 
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Parameters 



x d Synchronous Reactance (PU) 

x q Negative Sequence Reactance (PU) 

x / Transient Reactance (PU) 

x/' D-axis Subtransient Reactance (PU) 

x” Q-axis Subtransient Reactance (PU) 

Xj Armature Leakage Reactance (PU) 

7V Transient Open Circuit Time Constant (seconds) 

TV' D-axis Subtransient OC Time Constant (seconds) 

T " Q-axis Subtransient OC Time Constant (seconds) 

V Armature Time Constant (sec) 

H Inertia Constant (sec) 

p p Pole Pairs 

ij nl Field Current for no load rated voltage (amps) 

(£> bs Base System Frequency (rad/sec) 

0^ Base System Angle (radians) 

V SB Base System Voltage (volts) 

f*SB Base System Power (watts) 

V MS Base Machine Voltage (volts) 

PfilB Base Machine Power (watts) 

States 

0 S rotor angle wrt to synchronous frame (rad) 

D-axis flux-linkage (PU) 

Xf/js Q-axis flux -linkage (PU) 

e qS ” Q-axis voltage behind subtransient reactance (PU) 

ejs" D-axis voltage behind subtransient reactance (PU) 

e q s Q-axis voltage behind transient reactance (PU) 



- 270 - 



Equations 

Constant Definitions 

Base Quantities 



_ ^ p sb 
! sb “oTT - 

v SB 



T sb = 



SB 



(0 



'SB 



_ 2P MB 
‘MB ~~~- 



3 V, 



MB 



T = 

1 MB 



Pp P 



P ‘ MB 



00, 



'fci 



IjB =I fnl(Xd-Xol) 
P MB 



V m = 

* /, 






Other Constants 



x ad =x d -x al 



*/ = 



£ 



X d ~Xj 



r,= 



t &bs T do 



xh 



Xj-x d 



a = 



x/-x d " 
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Angle Calculations 



© = /(CO. - CO mPp )dt + 0 S 

0 = 5(0). — (i> m p p ) + ©so 
C e = cos(0) 



5 e = sin(0) 



Variable Rotation and Scaling 



V = 









V, 



FD 



R = 



V CD V SB 

M(C e ) ~M(S e ) 0 0 

V MB 



V m 

V 



MB 



M(S Q ) 

0 

0 






SB 






M(C e ) 0 0 



MB 



0 

0 






SB 



MB 



VsB 

0 — 

V 



v = RV 
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Solving the electrical dynamical equations 

The five electrical dynamical equations must be solved simultaneously. Since the 
Integration Matrix and Multiplication Matrix are linear matrices, the entire problem 
becomes a linear process. Hence the system of equations can be represented by a matrix 
equation. 

First define the integration and multiplication matrices 

j x(t)dt = Sx +x 5 ; S s 9T X " x s e 9T 

x ■ y =M (y)x ; M e 9T xn 



Now we define the system of equations 



A = 



,+ f 

1 ad 



SM(c o mPp ) 
-S 



p' 

/ / 
x* ~x d 



T "r ' 

1 do X d 

0 



0 



-SM(COn) - — 



/ + f 

T 

1 at i 



0 



T "jc " 

J qo -*q 

0 



S_ 

Tad 



0 



I + S- 



-s 



T "y ' 
1 do X d 

0 

a- 1 



T ' 

1 do 



i l 

T 



aq 

0 



I+S 



T "x " 

1 qo ~^q 

0 



0 



T ' 

1 do 

0 



I+S 



a 

T ' 

1 do 






x = 
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"(o fe 0 0 O' 

0 co fcj 0 0 

0 0 0 0 

0 0 0 0 

0 0 0 — 

L r /J 



Bs = 



'/ 0 0 0 0 " 
0/000 
0 0/00 
0 0 0 /0 
0 0 0 0 / 



^dSO 

%SG 

p " 

ZqSO 

p " 

e dSO 
_ e qSO 



b =B V V+B s s 0 



x = A~ l b 
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Calculating Export Variables 



First the currents in machine reference frame 



L = 



|>J 



C = 



_ 1 _ 

/, 

X d 

0 

0 

0 



0 ~ 0 

1 „ 1 

o — 



■'1 

0 

0 



0 

x u 



Xad(.Xf X^j) 



0 

0 



0 

0 

0 



Xaj(x f -x u ) 



i. = Cx 



Now the currents in system reference frame 



I = 



In 



1 Ft) 



R,= 



•mb 



I SB 

{l 

I SB 



M(C e ) 



•mb 



M(S e ) 0 0 



•SB 



— -^—M(S e ) 0 0 

•SB 



0 

0 



0 ^ 0 

•SB 



0 



0 



K = R,U 
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Torque Equation 



Tepu = W, “ V' 

_ 2H Pp d(£> m 
acc dt 






r„a s -. 



CD; 



'to 



r =—(T -t ) 

m rp \ acc epu / 



Structural Jacobian 

The structural jacobian for the DQO model is given by: 



~N 


N 


0 


N 


N 


N 


N 


0 


N 


N 


0 


0 


0 


0 


0 


N 


N 


0 


N 


N 


N 


N 


0 


N 


N 


N 


N 


0 


N 


N 


0 


0 


0 


0 


0 



Jacobian Calculations 

Calculating the jacobian of the export variables with respect to the import variables 
is straight forward with the exception of the partials with respect to the mechanical 
frequency. First of all, nothing depends on V 0 , hence all of its partials are zero. In the 
following derivations, the Device Jacobian is partitioned such that the voltages and 
currents are split from the mechanical speed and torque. 

I t =R£A-\BW+B s sJ 

a/, . 

— = R,CA~ i B v R y 
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Calculating the partials with respect to the mechancial frequency: 



Ax = B v R v V + B s s 0 



dx dA _ 3/? v 

d(0 m + 3(0 m A v 3(0 



where 



and 



dx 

3(0 m 






= A‘ 



3co„ 3w m 



^ =RiC *L + *l Cx 



3 ( 0 , 



3(o m 3(o„ 



) 



0 



a4_ 

3(o m 



SP, 



0 

0 



-Sp p 0 0 O' 

0 0 0 0 

0 0 0 0 

0 0 0 0 

0 0 0 0 



30 

3(o m 



-Sp, 



3/?„ 

3(o m 



V, 



SB 



V, 



M(S e )Sp 



MB 

VSB 






M(C e )S Pp 



MB 



0 

0 



7j~M(C e )S Pp 0 0 

v MB 

V SB 

r^-M(S e )S Pp 0 0 

'MB 

0 0 0 
0 0 0 
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dRj 

d(0„ 



1 MB 



M(S e )S Pp 



‘SB 

1 -^M(C e )S Pp 

‘SB 

0 

0 



-y -M(C e )S Pp 0 0 

‘SB 

/, 



T-M{S Q )S Pp 

‘SB 

0 

0 



0 0 

0 0 
0 0 



The Torque equation Jacobians are given by: 

dT m T sb dT, 



cpu 



dv t mb dv 



dT 






3K 



fry* 

■’* } dv 



dij_ 

'“'dV 



dv 



dy d dx 

W’ v 0 0 0 0] §k 



w =l ° ' 0 0 01 l 



di d di e 

5F= [/ 0 0 01 5k 



di di e 

5k = [0 1 0 01 5k 



Now with respect to the mechanical frequency: 



dT m 



’ SB 



da, 



m 1 MB 



dT dT, 



epu 



dc o m d(Q~ 



dr ace _2H Pf>s _ t 



da m 



co. 



} bs 



dT, 



di„ 






dh 






W(v? , M0 .,_ 
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~ = [7 0 0 0 0 ]A 

d(O m d(0„ 

^•=[0 7 0 0 0 ]#^- 

dco m d(O m 



d(o„ 



= [/ 0 0 0 ] 



A 

c>«„ 



di di, 

9 =[0 7 0 0]: 



dco. 



5 oo„ 



Putting the Jacobian all together: 






9/p 


dip 


0 


dip 


dI D ~ 


a^ D 


dVg 


dv F 


a co m 


dig 


dig 


0 


dig 


dig 


dV D 


dVg 


dv F 


d(O m 


0 


0 


0 


0 


0 




ar m 


0 


ar m 


dT m 


a\/ D 


av^ 


dv F 


d(O m 


dip 


dip 


0 


dip 


dip 


dV D 


dVg 


dv F 


do> m 


dig 


Big 


0 


dig 


dig 


dV D 


dVg 


dv F 


dco m 


0 


0 


0 


0 


0 
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F-1.2 ABC Model 



Interface Variables 



Terminal 



Potential Variable Flow Variables 



Stator Phase A 


V A (import) 


Stator Phase B 


V B (import) 


Stator Phase C 


V c (import) 


Mechanical 


co m (import) 


Field Voltage 


Vfd (import) 


Stator Phase A Current 


I M (export) 


Stator Phase B Current 


/ B i (export) 


Stator Phase C Current 


7 C , (export) 


Field Current 


/ F (export) 



I K (export) 
7 B (export) 
7 C (export) 

T m (export) 



The import x imp and export x exp vectors are defined by: 



X !m „ = 

i trip 



V, 



Vc 

Vfd 

ccl 



X '■ 

exp 



Parameters 

All Parameters are identical to the DQO Model 

States 

All States are identical to the DQO Model 

Equations 

Constant Definitions 

All Constants definitions are identical to the DQO Model 



(KCL Group) Type 

(1) Normal 
(1) Normal 
(1) Normal 

(0) Normal 

Information 

Infonnation 

Information 

Information 

Information 
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Angle Calculations 

For this model, the angle is the actual rotor angle of the synchronous machine: 

® = j + ©50 
Q = S (£> m P p + ©S0 

Note: When calculating Q S1 it would be wise to limit its range to ±ji. 

Variable Rotation and Scaling 

To convert from the V vector to the v vector, Parks transformation should be used: 



V = 



Va 

Vs 

Vr 






FD 



R = 



2V< 



SB 



y 3V, 



MB 



M (cos(©)) M 



cos 



0 - 



2k 



\\ 






M cos 



JJ 



0 + 



2k 






0 

0 

0 

3 1 'mb 
2V^ 



Solving the electrical dynamical equations 

The electrical dynamical equations are solved in exactly the same way as for the 
DQO model. 





f 


f 2 nY 


\ 


f 


f 27lYl 


M(sin(©)) - M 


sin 


0-- 


-M 


sin 


0+- 




V 


l 3 / 


/ 




^ 3 JJ 


1 




1 




1 


2 




2 




2 


0 




0 




0 






= R v V 
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Calculating Explicit Variables 

The only difference for calculating the explicit variables are the following 
matrices: 



/ = 



FP 






1 MB 



1 SB 



Af(cos(0)) 

m{ cosf©-^r 



m| cosf 0+^ 



-M(sin(©)) 



— M sir 



-M 



sin 



e-f, 

e+ T 






0 



0 



Structural Jacobian 

The structural jacobian for the ABC model is given by: 



Jds ~ 



~N 


N 


N 


N 


N' 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 



1 

1 

1 

0 



0 ' 
0 

0 

ha 

I MB 



Jacobian Calculations 

The only differences for calculating the jacobian matrices are the following: 

ae 






■ = s Pp 
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dR v 2V, 



SB 



da> m 3V, 



MB 



-M(sm(Q))S Pp 

- M (cos(0))5 p p 

0 

0 




271 ' 


) 




f 


< 2k Yl 




I s / 7 /. 


-M 


sin 

V 


. e+ T 


2 jO 


\ 


| 


( 


r 2k V 




Sp„ 


-M 


cos 


0 +— 



0 

0 



dR, 



I MB 

17 



SB 



-M(sin(0))S/? 



JJ 



— A/f ( r.nc( faWS n 



0 

0 



SPr 0 



>P P o 

0 

0 



— A/ sin 



— M\ sin 




Putting the Jacobian all together: 



— 



\di A 


dI A 


dI A 


dI A 


dW 


dv A 


dV B 


dV c 


dV F 


d(0 m 


dI B 


dI B 


dI B 


dI B 


dI B 


dv A 


dV B 


dV c 


dV F 




dl c 


dl c 


dl c 


dl c 


dl c 


dV A 


dV B 


dV c 


dV F 


d(x> m 


dT m 


dT m 


dT m 


dT m 


dT m 


dv A 


dV B 


dV c 


dv F 


dco m 


dI A 


dI A 


dI A 


dI A 


dI A 


dV A 


dV B 


dV c 


dv F 


d(a m 


dl B 


dI B 


dI B 


dI B 


dl B 


dV A 


dV~ B 


dv c 


dV F 


d(£> m 


dl c 


dl c 


dl c 


dl c 


dl c 


dv A 


dV B 


dV c 


dV F 


dc 0 m 
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F-2 Voltage Regulator Model 

This is a simple voltage regulator model. The voltage regulator is assumed to be of a 
PI type controller. This design does not have any clipping on the output waveform to 
ensure the field voltage is kept within a reasonable range. This model is intended for single 
generator operation since it has no provision for reactive power sharing with paralleled 
generators. 



F-2.1 DQO Model 



Interface Variables 



Tenninal 



Potential Variable Flow Variables Type 



Line Direct Voltage 
Line Quadrature Voltage 
Reference Voltage 
Field Voltage 



V D (import) 
V Q (import) 
V ref (import) 
V FD (export) 



Information 

Information 

Information 

Infonnation 



The import x imp and export x txp vectors are defined by: 




x 




Parameters 



k P 



Integrating factor (1 / sec) 

Proportional factor (PU) 

Voltage Magnitude Conversion factor (PU) 




States 



v /d5 

Equations 



Field Voltage 



Calculate the terminal voltage: 



V, = k DQO ylV D -V D + V Q -V Q 



Calculate the error voltage: 
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Calculate the Field Voltage: 



V, 



FD 



-I* 



V err dt+k p V, rr + V fJS 



Structural Jacobian 

The structural jacobian for the DQO model is given by: 

J ds = [N n L ] 



Jacobian 



dv. 



FD 



= k,S+k p I 



= —kjS - k I 



dV ref 

d^FD 

"avT 

aVyrp dV FD dV, 

av^ = dv, W D 

dV^JVfpdV, 
dV Q dV, dV Q 

Note the partials of V, with respect to V D and V Q must be determined from the square root 
function: 



Vn 



HL-t - 
d\’ D DC " v, 



*L_ V, 
W V, 



The device jacobian is given by: 



Jn = 



dV FD dV Fn dV; 



FD 



' FD 



D L dv D av c dv ref 



-285 - 



F-2.2 ABC Model 



Interface Variables 



Terminal 



Potential Variable Flow Variables Type 



Phase A Voltage 
Phase B Voltage 
Phase C Voltage 
Reference Voltage 
Field Voltage 



V A (import) 
V B (import) 
V c (import) 
V ref (import) 
V FD (export) 



Information 

Information 

Information 

Information 

Information 



The import x mp and export x exp vectors are given by: 



x. 



imp 



Parameters 



V 

v B 

Vc 



X~ P = Wfd\ 



k t Integrating factor ( 1 / sec) 

k P Proportional factor (PU) 

^abc Voltage Magnitude conversion factor (PU) 

States 

Vf* Field Voltage 

Equations 

Calculate and subtract out the DC offset of the common potential: 

.. Va + Vb + Vc 

o 3 

y^A-v* 



V B0 = Vg-V o 
Vco = Vc-yo 
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Calculate the Terminal voltage 1 : 



V. = *ABC 



VI 



(v«-K» + t'„-v„ + v al .i« 



Calculate the Error voltage: 



V„ = V«-V, 



Calculate the Field Voltage: 






VFD=\W rr dt+k p V err + V fdS 



Note 1: Derivation of Terminal Voltage: 

Assume phase voltages are balanced three phase: 

V A0 = V r cos(0) 



V B0 = V T cos 



( 2k ^ 
0 + - 

3 J 



V co ~ ' 7 r cos © 



2k 



7 2 2 V T 

V 7 A0 + V 2 B0 + V 2 C0 =^-(l+cos(2Q) + 



1 +cos(20)cos 



^47:^ 



J J 



-sin(20)sin 



47t^l 

tJ + 



( 4k\ 47t 

l+cos(20)cos — +sin(20)sin — 

3 J 3 , 



y 2 + y 2 + y 2 - -y 2 
v ao ^ v bo f v co 2 v T 



Structural Jacobian 

The structural jacobian for the ABC model is given by: 

J ds = [N N N L] 
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Jacobian 



dv, 



FD 



dVrcf 

MFD 

dV, 



= kjS + k p I 
- -k t S - k I 



dV FD _ dV FD dV, 
dV A ~ dV, dV A 

dV F d dV pp dV, 

~dv^ = ~dv^dv B 

dV F D dV FD dV, 

~dV^ = dV, dVc 

Note the partials of V, with respect to V A , V B , and V c must be determined from the square 
root function: 

dV, V A0 

dV, _ V B0 f 2 

dV B0 Kabc V, \3 

dV, _ V co 

dV C0 kABC V, 





dv, 


2 dV, 


1 dV, 


1 dv, 


dv A 


'*dV M ~ 


~3dV B0 ' 


~ 3 dV C0 


dv, 


1 dV, 


2 dV, 


i av; 


II 

ro 


3dV A0 


+ 3dV B0 


3dV C0 


dv, _ 


1 dV, 


1 dV, 


2 dV, 


dV c 


3dV M 


3dV B0 


3 dV C0 
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The device jacobian is given by: 



Jd = 



^fd 

5^7 



Wfd 

dV B 



dV c 



d V r,f 
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F-3 Prime Mover 



This is a rather crude model of a PI controller on a prime mover. The dynamics of the 
controller are assumed to dominate the response of the prime mover. 

Interface Variables 

Terminal Potential Variable Flow Variables (KCL Group) Type 

Mechanical co m (import) T m (export) (0) Normal 

Information (£> ref (import) Information 

The import x imp and export x exp vectors are defined by: 

Parameters 

kj Integrating Torque factor (1 / sec) 

k P Proportional Torque factor (PU) 

(£> bs base frequency (rad/sec) 

Psb base System Power (watts) 

Pmb base Machine Power (watts) 

States 

T^ mechanical torque 

Equations 



^ imp 



00 „ 



to. 



W 



_ Pmb [ ( ki , . . kp , 

T "' = ~p~\ 7r (o V ~ ^ )dt + 7T (o V “ (0 - ) 

Psb <£>bs <O b , 



+ T. 



mS 



Structural Jacobian 

The structural jacobian for the Prime Mover model is given by: 

J ds =[L L] 
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Jacobian 



~dT m _ P mb k 
d«W ~ Psb <J\s 

ar„_ dT m 

d(0 m doi ref 



J D ~ 



I— 

dco m 




F-4 Three Phase Switch 



F-4.1 DQO Model 
Interface Variables 



Terminal 



Potential Variable Flow Variables (KCL Group) Type 



TD1 

TQ1 

T01 

TD2 

TQ2 

T02 

SW 



V DI (Import) 
V Q1 (Import) 
V 01 (Import) 
V D2 (Import) 
V Q2 (Import) 
V 02 (Import) 

S w (Import) 



hi (Export) 
I Q1 (Export) 
hi (Export) 
I D2 (Export) 
I Q2 (Export) 
I 02 (Export) 



(1) Normal 

(2) Normal 

(3) Normal 

(1) Normal 

(2) Normal 

(3) Normal 

Information 



All Interface variables are on a Per Unit (PU) Basis 



The import x ^ and export x exp vectors are given by: 



I 




Idi 


v Qi 




l Ql 


Pol 


X = 


A>. 


V D 2 


a p 


^ D2 


V Q2 




J Q2 


“1 

1 




_ ^ a2 _ 
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Parameters 



G on On Conductance (PU) 

G off Off Conductance (PU) 

States 



There are no states for this model. 



Equations 

The equations for the switch are very simple. First, we define the conductance G of 
the waveform: 



If 


S w >0 


Then 


Q) 

II 

P 

3 


Else 


O 

II 

o 

*§l 



Now Generate the Conductance Matrix G D : 



M(G) 


0 


0 


M(-G ) 


0 


0 


O' 


0 


M(G) 


0 


0 


M{-G) 


0 


0 


0 


0 


M( G) 


0 


0 


M(-G) 


0 


M(-G) 


0 


0 


M(G) 


0 


0 


0 


0 


Af(-G) 


0 


0 


M{G) 


0 


0 


0 


0 


M(-G) 


0 


0 


M(G) 


0. 



The export variables are simply: 

X*p = G D* mp 

Structural Jacobian 

The structural jacobian is given by: 
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•*DS - 



N 0 0 
0 N 0 
0 0 N 
N 0 0 
0 N 0 
0 0 N 



N 0 
0 N 
0 0 
N 0 
0 N 
0 0 



0 N' 
0 N 
N N 
0 N 
0 N 
N N 



Jacobian Calculations 



The jacobian matrix is very similar to G D : 




M(G) 


0 


0 


0 


M(G) 


0 


0 


0 


M(G) 


M(-G) 


0 


0 


0 


M(-G) 


0 


0 


0 


M(-G) 



M(— G) 
0 
0 

M(G) 

0 

0 



0 0 
M(-G) 0 

0 M(-G) 

0 0 
M(G) 0 
0 M(G) 



M{V D1 -V D2 ) 



dG 



dSw 
dG 

M(V Q1 - V Q2)#r 



M(V o.-VJ 
M(V D2 -V D1 ) 



dG 

01 ~ ro 2 ) ds^. 

dG_ 

dS w 

dG 

M(y m -v o,) 



dS h’ 



Where is detennined by the If-Then-EIse function. 
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F-4.2 ABC Model 



Interface Variables 



Terminal 



Potential Variable Flow Variables (KCL Group) Type 



TA1 

TB1 

TCI 

TA2 

TB2 

TC2 

SW 



V M (Import) 
V B1 (Import) 
Vci (Import) 
Vju (Import) 
V B2 (Import) 
V C2 (Import) 

S w (Import) 



I AJ (Export) 
I BI (Export) 
hi (Export) 
/ At (Export) 
I B2 (Export) 
I C 2 (Export) 



(1) Normal 

(2) Normal 

(3) Normal 

( 1 ) Nonnal 

(2) Nonnal 

(3) Normal 

Information 



The import x ^ and export x exp vectors are given by: 



1 

1 




"V 


V« 




hi 


hi 


X = 


hi 


V*2 




1*2 


Vb2 




hi 


V d. 







Parameters 



G on On Conductance (PU) 

G off Off Conductance (PU) 

States 



There are no states for this model. 



Equations 
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The equations for the switch are very simple. First, we define the conductance G of 
the waveform: 



If 


S w > 0 


Then 




Else 


G ~ G off 



Now Generate the Conductance Matrix G D : 



M(G ) 


0 


0 


M{-G) 


0 


0 


O' 


0 


M( G) 


0 


0 


M(-G) 


0 


0 


0 


0 


M(G) 


0 


0 


M(-G) 


0 


M(-G ) 


0 


0 


M(G) 


0 


0 


0 


0 


M(-G) 


0 


0 


M{G) 


0 


0 


0 


0 


M(-G) 


0 


0 


M{G) 


0 



The export variables are simply: 

^cxp G D x imp 



Structural Jacobian 



J DS ~ 



N 

0 

0 

N 

0 

0 



0 0 jV 0 0 jV" 

N 0 0 N 0 N 

0 N 0 0 N N 

0 0 jV 0 0 N 

N 0 0 N 0 N 

0 N 0 0 N N_ 
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Jacobian Calculations 



The jacobian matrix is very similar to G D : 



M(G ) 0 

0 M(G ) 
0 0 
M(-G ) 0 

0 M(-G) 

0 0 



0 

0 

M(G) 

0 

0 

M(-G) 



M(—G) 0 

0 M(-G) 

0 0 

M(G) 0 

0 M(G) 

0 0 



0 MiV^-V^) 
0 M(V B1 -V B2 ) 
M(-G) M (V C1 - V C2 ) 
0 

0 M(V B2 -V B1 ) 
M(G) M (V C2 - V C1 ) 



dG_' 

dSw 

dG_ 

dS^ 

dG 

dSw 

dG 

dSw 

dG 

dS w 

dG_ 

dS w 



Where r— is determined by the If-Then-EIse function. 
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F-5 Transmission Line 



DQO Model 



Interface Variables 



Terminal 



Potential Variable Flow Variables (KCL Group) Type 



T DI 


V D1 (Import) 


I DI (Export) 


Tq, 


V QI (hnport) 


Iqi (Export) 


T 01 


V 01 (Import) 


I 01 (Export) 


Td2 


V D2 (Import) 


l D2 (Export) 


Tq2 


V Q2 (Import) 


I Q2 (Export) 


Tq2 


V 02 (Import) 


hi (Export) 



The import x ^ and export x exp vectors are given by: 



(1) Normal 

(2) Nonnal 

(3) Normal 

(1) Normal 

(2) Normal 

(3) Normal 



1 




1 Dl 








Vox 


X = 


4)1 


V D2 


exp 


^ D2 


V Q2 




! Q2 


1 

1 




. ^ 2 ^ 



Parameters 



R Resistance (ohms) 

X Reactance (ohms) 

States 



(There are no states for this model) 



Equations 



Constant Definitions 



G = 



R 

X 2 + R 2 



I 



Y 



X 

x 2 +r 2 



I 
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Calculate the Export Variables 



J d ~ 



G 

Y 

0 

-G 

-Y 

0 



-Y 

G 

0 

Y 

-G 

0 



0 

0 

/ 

r 

0 

0 



/ 

r 



-G 

-Y 

0 

G 

Y 

0 



Y 

-G 

0 

-Y 

G 

0 



0 ' 
0 

_/ 

r 

0 

0 

/ 

r 



^cxp ^ 0^ imp 



Structural Jacobian 

The Structural Jacobian is given by: 



3 ds ~ 



~D 


D 


0 


D 


D 


O' 


D 


D 


0 


D 


D 


0 


0 


0 


D 


0 


0 


D 


D 


D 


0 


D 


D 


0 


D 


D 


0 


D 


D 


0 


0 


0 


D 


0 


0 


D 



Jacobian Calculations 

The matrix J D is the Jacobian matrix. 
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ABC Model 



Interface Variables 



Tenninal 


Potential Variable 


Flow Variables 


(KCL Group) Type 


t a , 


V Ai (Import) 


/ ai (Export) 


(1) Normal 


Tb, 


V B , (Import) 


I B1 (Export) 


(2) Nomial 


T c , 


V C1 (Import) 


1 CI (Export) 


(3) Nonnal 




V m (Import) 


/ ai (Export) 


(1) Normal 




V B2 (Import) 


l B2 (Export) 


(2) Normal 


T a 


V C2 (Import) 


I C2 (Export) 


(3) Normal 


The import 


x^p and export jr^ vectors are 


given by: 





imp 



, 

1 




~ I Al~ 


V U 




^B1 




x = 


la 


Vai 


exp 


^A2 


Vs: 




hi 


1 




n 

i 



Parameters 



R 

G 

L 

States 



Series Resistance (ohms) 
Parallel Conductance (mhos) 
Inductance (henries) 



•al 

^bl 



' CL 



Phase A Inductor Current 
Phase B Inductor Current 
Phase C Inductor Current 



Equations 

Each of the three phases can be treated independently of one another. In the 
equations which follow replace a subscripted X with the appropriate phase letter: 

First write the equations describing the phase: 



R 

1 



-f- 



xi 



XN 



-I 

0 



0 

G+- 



0 



xi 



V: 



X2 



l XLO 



= 0 
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V 



l XL 



-I 



° -R-° 







- 




^ XI 


+ 




.V 





0 0 0 ' 



- 


i — 
•*>1 

t 








IxLD_ 



Manipulating the first matrix equation, we can get an expression for the terminal 1 
current: 



G,,= -S+tfG+7 



y- 


fs A 


fs ) ,] 








) . 


. 1 ^ J 


U J J 



Ix,=G iv 



V. 



XI 



X2 



I XL0 



Once this is known, the other variables are easy to calculate: 



Kxv — Vxi R^xi 



^xl - ~f ^ + G 4- ^ + G Vx? 



^X2 ~ I xi 



Structural Jacobian 

The Structural Jacobian is given by: 



Jds — 



L 

0 

0 0 



L 
0 L 
0 0 



0 0 L 0 0 

L 0 0 L 0 

0 0 L 

L 0 0 

0 0 L 0 

L 0 0 L 



L 

0 0 



300- 



Jacobian Calculations 



The Jacobian Matrix can be directly constructed from the first element of G IV : 



G n = 



R 



S+RG+I 




J D = 



0 

0 

~ G n 

0 

0 



0 

G ll 

0 

0 

-G t 

0 



11 



0 

0 

G 

0 

0 

-G 



-G u 0 0 ' 

0 -G„ 0 

0 0 ~ G u 

G u 0 0 

0 G n 0 

0 0 G„ 

1 1 J 



-301 - 



F-6 Constant Impedance Loads 
DQO Model 
Interface Variables 

(KCL Group) Type 

(0) Normal 
(0) Normal 
(0) Normal 



Terminal 



Potential Variable Flow Variables 



T d 



V D (import) 
Vq (import) 
v 0 (import) 



I D (export) 
Iq (export) 
I 0 (export) 



The import x ^ and export x vectors are given by: 



1 




Id 




II 


J Q 


1 

1 




1 



Parameters 



R Load resistance (ohms) 

X Load reactance (ohms) 

G gnJ Zero Sequence conductance to ground. 

States 



(There are no states for this model) 



Equations 

First calculate the admitance 



G = 



R 



R 2 +X 2 



Y = — 



R 2 +X 2 



Now calculate the Admitance Matrix: 



G • = 



"G 

Y 

0 



-Y 

G 

0 



0 ‘ 
0 



^exp ^ vX imp 
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Structural Jacobian 

The Structural Jacobian is given by: 



D 


D 


0 


D 


D 


0 


0 


0 


D 



Jacobian Calculations 

The jacobian matrix is the G„ matrix. 
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ABC Model 



Interface Variables 



Term in a] 



Potential Variable Flow Variables (KCL Group) Type 



T a V a (import) J A (export) 

T b V b (import) I B (export) 

T c V c (import) I c (export) 

The import x ^ and export x eip vectors are given by: 



(0) Nonnal 
(0) Normal 
(0) Normal 



Parameters 





i 

i 




1 

>> 
1 


II 

1 

H 


v* 




1 

l 



R Series Resistance (ohms) 

G Parallel Conductance (mhos) 

L Inductance (henries) 

R CiND Resistance of center to Ground (ohms) 

States 

U Phase A Inductor Current 

^bl Phase B Inductor Current 

Id. Phase C Inductor Current 

Equations 

This load model can be considered to be a transmission line where all the terminals of one 
side are connected together to a resistor going to ground. As such, we can use some of 
the derivations from the transmission line model: 



G 



31 — 






yS+RG+I 

jL 



V 1 

J 



G \\ 




\ 

) 



~ G U V X G n V X2 + G^Ixlq 
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This can be rewritten by defining the following matrix: 





(/ “h Rqnd ^ 1 1 ) 


RgndG ii 


Rgnd 


G xx 


G ABC ~ 


RgndG ii 


(/ + RqhdG n ) 


R-GSD 


G\\ 




RgndG ii 


RgndG ii 


(I +R cm G ,i) 



Which allows the following equation to be written: 





■// 




G \l 


0 


0 ■ 




~v A - 




G 31 


0 


0 ‘ 




^alo 


G ABC 


h 


= 


0 


G n 


0 




V B 


+ 


0 


<^31 


0 




hii) 




l C 




0 


0 


G ". 




Vc 




0 


0 


G 31_ 




JcL0_ 



Or if we rewrite the equation: 







G n 


0 


0 ' 


"V/ 




G 3l 


0 


0 ' 




Ialo 




“ ^ABC 


0 


G n 


0 


V B 


+ G abc 


0 


<^31 


0 




Iblo 


Jc_ 




0 


0 


G u_ 


1 

1 




0 


0 


G 31. 




JcL 0 _ 



The inductor current for phase X can be determined from: 



Kxw - RIx 



I XL — 



\ V x 

~R + G ] v xn + ~^ + GR cnd( I a +I b +i c) 



R 



R 



Structural Jacobian 



The structural jacobian is given by: 



^ds - 



L 

L 

L 



L 

L 

L 



L 

L 

L 
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Jacobian Calculations 

The Jacobian Matrix is given by: 



J d — G ABC 



G n 

0 

0 



0 0 
G u 0 
0 G„ 
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F-7 Reduction Gear 



Interface Variables 

Terminal Potential Variable Flow Variables (KCL Group) Type 

51 co, (export) T t (export) (0) Normal 

52 COi (import) T 2 (import) (0) Normal 

The potential variables are measured in radians/second while the flow variables are 
measured in Newton-meters. 

The import x imp and export x exp vectors are given by: 





X = 


'co,' 


T 

_ 1 2_ 


exp 


A 



Parameters 

rtj Number of teeth on shaft 1. 

n 2 Number of teeth on shaft 2. 

rj Efficiency of Reduction Gears. 

States 

There are no states for this model. 

Equations 

The rotational speed of the shafts are proportional to the gear ratio: 

«1 
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The transmitted torque however, must be scaled by the efficiency. Which side of the 
equation the efficiency applies depends on the direction of the power flow: 



if 

then 



else 



T 2 (Oj > 0 

n \ 

T '-n^ 



T, 



n i 

—t 2 
'hr 1 



The first zero crossing of the power should be passed back to the system as a 
suggested recalculation time. 

Structural Jacobian 



The structural jacobian is given by: 



■Jds ~ 



D 

N 



O' 

N 



Jacobian Calculations 



The jacobian is given by: 



Jo = 



n 2 
>h 

ar, 

d(£h 



0 

dr, 

dr 2 



The partials of Tj depend on the partial derivatives of the if-then-else function. If 
the direction of the power flow remains constant over the interval, then the partials are 
given by: 



F-8 Propeller 



The relationship between the torque, angular speed, forward velocity and forces on a 
propeller are highly complex and nonlinear. While much infonnation is known about the 
steady-state operation of propellers traversing in the forward direction, little infonnation is 
available for nonstandard operating conditions. The classical approach is to generate K, vs J 
and K. vs J curves where: 




F = K t (J) p£>V 

T m =K Q (J)pD 5 n 2 

where the variables are described in the following sections. 

The classical approach works well when V p (speed of propeller with respect to the 
fluid) and n (RPM of shaft) are both positive and n is large enough to bring J (advance 
coefficient) below about 1.5. Outside of this range, little data is provided for most 
propellers. The classical approach breaks down completely when the shaft speed is zero 
and J is infinite. Furthennore, there is no way to differentiate between backing down (n 
and V p both negative) and having forward way on ( n and V p both positive). The method 
used for this model is better suited for simulation studies because it essentially uses the 
angle of attack on the propeller blade as the argument for the thrust and torque coefficients. 
This model is based on work conducted at the Naval Ship Research and Development 
Center, Annapolis, MD by D. W. Baker and C. L. Patterson and reflects data and theory 
developed by I. Ya. Miniovich. 

Interface Variables 

Terminal Potential Variable Flow' Variables (KCL Group) Type 

Mechanical co OT (import) T m (export) (0) Normal 

Hydrodynamic u (import) F (export) (0) Nonnal 

Note: units are radians! second. Newton-meters , meters! second, and Newtons 

The Import and Export X exp vectors are defined by: 
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Parameters 



X 



imp 





1 

£ 

. 1 


x = 


\T m 1 




u 


exp 


F _ 



D Diameter of Prop ( meters ) 

w Wake Fraction (PU) 

p Density of water ( kglm 3 ) 

Cji) Thrust Coefficient matrix (unlimited rows by 2 columns) 

first column is 0 in radians [-71 re] 
second column is Thrust Coefficient in PU. 

C e 0 Torque Coefficient matrix (unlimitd rows by 2 columns) 

first column is 0 in radians [-7t 7t] 
second column is Torque Coefficient in PU. 

States 



(There are no states for this model) 



Equations 



Vp = (1 -W)u 



0 = atan2 (nD , V p ) 

F=~C T (Q)pD 2 (V 2 + n 2 D 2 ) 

T m = C Q (Q) pD\V 2 + n 2 D 2 ) 

Normally, C T () and C Q ( ) are specified as data points. Hence some type of 
interpolations scheme is needed to determine the value of theses functions at intermediate 
points, as well as the value of the first derivative. 

Device Structural Jacobian 

The Device Structural Jacobian for all waveforms is given by: 



-310- 



J DS ~ 



N N' 
N N 



Jacobian Calculations 

Calculate partials with respect to intermediate variables 

dF_ n ,dF_ 

du 0 w) dV„ 



du ( M) dv„ 



dF 1 dF 
do$ m 2 k dn 



dT m 1 dT m 



9(0 m 2k dn 



Calculate the partials 

dF 



w P = - pD 



2C,(0)i' +(V'; + ,rD ! ) 



aCrO)'! 



dv, 



p J 



dF 

dn 

dT, 






dv, 



- -pD 
= pD 



2 C T (Q)D 2 n + (V 2 + n 2 D 2 ) 



dCrj 9 ) 
dn 



a7 =po 



V 

, , , acgC©)^ 

2C Q (Q)V p + (V 2 + n 2 D 2 ) 

OVp J 

dC Q 0)' 



2C Q (G)D 2 n+(V 2 + n 2 D 2 )-^ 



Calculate the partial of 0 with respect to V and n. 



dG 

dV, 



i 

nD 



P 1 + 



(ST 
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V 

dQ ~Vd 




Of course, the partials of CY(0) and C c (0) with respect to 0 must be determined 
from the interpolation scheme used. 

Putting all of this together: 



1 

QJ 


*r m ] 


d(Ji m 


du 


dF 


dF 


_ d(0 m 


du _ 



- 312 - 



F-9 Ship Dynamics Model 
Interface Variables 

Terminal Potential Variable Flow Variables (KCL Group) Type 

Ship Hydrodynamics u (import) F (export) (0) Normal 

Velocity u is measured in meters/second while force F is measured in Newtons. 
The import x imp and export x txp vectors are given by: 

x ;mp = [u] x„ p = [F] 

Parameters 

p Density of Salt Water (kg/m 3 ) 1025.9 kg/m 3 @ 15° C. 

v Kinematic Viscosity of Water (rrf/sec) 1.19x1 O' 6 m 2 /sec @15° C. 

G Acceleration of Gravity (m/sec 2 ) 9.80665 m/sec 2 

L Length of Ship (m) 

A s Surface Area of Ship (m 2 ) 

m Mass of Ship (kg) 

m add Added Mass Multiplier (PU) (normally between 1.0 and 1.10) 

C a Correlation Allowance 

Cj(R e ) Matrix of Frictional Drag Coefficients (2xn) or (3 x/i) 
column 1 are Reynolds Number Values 
column 2 are Frictional Drag Coefficient Values 
column 3 are optional first derivative values of the curve 
Note: Values should be provided for negative Reynolds Numbers 

C r (F r ) Matrix of Residual Drag Coefficients (2x/i) or (3x/i) 
column 1 are Froude Number Values 
column 2 are Residual Drag Coefficient Values 
column 3 are optional first derivative values of the curve 
Note: Values should be provided for negative Froude Numbers 

States 

There are no states associated with this device 
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Equations 



The basic equations are given by: 




F = 



u 

Vgl 



C T = C^R t ) + C r (F r ) + C a 
_ P 2 A n . dli 

F = 2 U A S C T + m oJ4 m ~^ 

The only potential difficulty is performing the evaluation of the drag coefficients 
C/i? e ) and C r (F r ). 

Structural Jacobian 



The structural jacobian is given by: 



J DS = W] 



Jacobian Calculations 






Jn=bA. 



M(u)M(u) 



( j ( 

-M 






v 



dCj(R e ) 

dR, 



'[LG 



M 



dC r {F r ) 

dF r 



\\ 



JJ 



+ 2 M(u)M(C,(R e )) + 



m adJ mS 



-1 



dC^ e ) dC r (F r ) 

where S is the integration matrix and must be determined by either 



differentiating the Cj(R f ) (C r (F r )) curve or by interpolating the third colum if so provided. 
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F-10 Pulse Generator 



Interface Variables 



Terminal 



Potential Variable Flow Variables Type 



VO 



V (export) 

The import x imp and export x exp vectors are given by: 

x mp = 0 



Infonnation 



x ' 



exp 



= [V] 



Parameters 




Value of V when off 
Value of V when on 

Matrix of pulse times (2 xn,): 



column 1 are pulse on times, 
column 2 are pulse off times, 
unlimited number of n, rows. 



States 

None 

Equations 

If the time t falls between an on and an off time then V = V on , otherwise y = 

If a discontinuity falls within the time interval, the earliest discontinuity time should 
be passed back as a recommended recalculation time. The time of the next discontiuity 
after the time interval should also be made available to the system solver. 

Structural Jacobian 

There is no structural jacobian matrix for this device. 

Jacobian Calculations 

There is no jacobian matrix for this device. 
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F-ll Induction Motor 



F-ll.l ABC Model 
Interface Variables 



Terminal 



Potential Variable 



Flow Variables (KCL Group) Type 



Phase A 
Phase B 
Phase C 
Neutral 

Mechanical 



V A (Import) 
V B (Import) 
V c (Import) 
V 0 (Import) 

co m (Import) 



I A (Export) 
I B (Export) 
I c (Export) 
I 0 (Export) 

T m (Export) 



(1) Normal 
(1) Normal 
(1 ) Normal 
(1) Normal 

(0) Normal 



Voltages are in volts, currents in amps, 
Torque in Newton-meters. 



angle speed in radians per second and 



The import x ^ and export x txp vectors are given by: 



>5 










Is 




X „ = 

exp 


Ic 






h 


co m 

m 




1 — 
1 



Parameters 



R s Stator Resistance (ohms) 

R r Rotor Resistance (reflected to Stator) (ohms) 

X ls Stator Reactance (ohms) 

Xlr Rotor Reactance (reflected to Stator) (ohms) 

X M Mutual Reactance (ohms) 

J Moment of Inertia (Kg-m 2 ) 

(£> hs Base Frequency (radians per second) 

p p Pole Pairs 

B Windage Torque Factor (Newton-Meters-second) 
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States 



0 Electrical Rotor Angle (radians) 

Equations 

First calculate the electrical angle: 

0 = 0o + jp p M m dt 

Now specify the following stator voltage and current vectors: 





l 

i 

1 




1 

1 


II 


Vb-Vo 


II 


h 




1 

1 

1 




1 

1 



The Rotor voltages and currents as reflected on the stator are: 



v r = 



y AJt 

V B r 

Vat' 



Calculate the inductances: 



b ~ 



Xls 

L - — I 

Mbs 



v= 



M =—I 

Mbs 



L = 

ms 



The Stator induction matrix is given by: 





2 ^ ms 


- l -L„ 

^ ms 


~2 Lms 


( L ls +L ms) 


~2 L ™ 


2 l ^ ms 


--L„, 

^ ms 


(Lu+Lms) 



The Rotor induction matrix is given by: 



v= 



(V+4J 


2 


1 

~l Lms 


~2 Lms 


(V+AJ 


~2 Lms 


~2 Lms 


2 ^ms 


(W' + LJ 



The Mutual induction matrix is given by: 



I ' - 






M (cos(0))L„ 



M 






cos 






0 + 



2n 



f 


f 


2 K 


Yi 


COS 


0- 


— 




l 


V 


3 


J; 


f 


? 


2k 




cos 


0 + 






V 


V 


3 


)) 



M(cos(0))L w 



M 

M 





f 2 tO 


) 


cos 








l 3 J 


J 




fo 2lt \ 




cos 


e +— 






l 3 J 


J 



M 



( 


' 2*Y| 


cos 


0 - — 




v 3 JJ 



L„ 



M(cos(0))L w 



The Rotor and Stator resistance matrices are given by: 
R' = R d 



"/ 


0 


O' 




'/ 


0 


O' 


0 


i 


0 


R s= R S 


0 


I 


0 


1 

O 


0 


/ 




_0 


0 


/ 



The system of equations which need to be solved can be expressed as: 



R s +S~'L S S-’V 

-l/r tsT n / , c-lr / 



s \Lsr) r;+s- i l/ 

For a squirrel cage induction motor v/ = 0. Hence the rotor curents can be solved 



for: 



b? -Ars^s 



A rs = -(R: + S-'L r ')-'s-\L sr ') t 



A RS = -(SR r '+L R T l (L SR ') T 
Now the stator currents can be solved for 
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Ass ~ (A» S L s +S L SR A rs ) 



-i 



l s ~ v s 



The neutral current is solved using KCL; 



A) — I a h h 



The electrical torque is given by: 



T=- 



3 ( 0 , 



’bs 



MV.MU-'-f-'-fY 






J ' J ' 
l AR *BR 



MVcW\W-~-f sin(9) + 



-(M(/ A )M(V-/ c /)+M(4)M(/ c /-/^0+M(/ c )M(/ yU? '-/,/))cos(e)} 



The full torque equation is given by: 

T m = -T t + (JS~ } +BI)ca m 



Structural Jacobian 



~N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 


N 
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Jacobian Calculations 



The jacobian elements corresponding to the electrical variables are easy 
calculate. If we partition the jacobian matrix as follows: 



where 





1 

ft 


AssVi 


J ew 


II 


Ui^ss 


U]A SS U X 


UVe* 




1 


J TE U X 


J TW 



U t = 



-1 

-1 

-1 



The remaining matrices {Jew, J te , and Jjw) are not as easy to calculate: 






= A 



-i ■ 

ss J s 



Take the partial wrt co m : 



_ d(A s J) . d/ s 

0 — ~ l s + ^55 



5(0„ 



9(o„ 



dis 

d(0„ 



' — Jew ~ A ss S 



_i d (L s /A RS ) 

doa m s 



L SR Ars — J'SR (SR r + L r ) {L sr ) 



d(L SR 'A RS ) d(L S!< ') T dL SR T 

-^-^ = - Ls - ( SR /+ L g r'^-^SR/ + L R r\L ss Y 






d(£>,„ 



M(sm(Q))L ms Sp p Ml sin 



2k 



W 



:-| Ml sin| 0-y 

(_ 2 kW 



Ml sin 



0 + T # , 

3 JJ 



( n 2^ 

e+— 



JP„ M\ sin 






\\ 



JJ 
2k" 



L n,,SP P 



L ms Sp p M (sm(Q))L ms S p p M\ sin) 0 + — L ms Sp p 



LJSP, M 



sin 



^ 9 



I sSp. 



3 JJ 

M (sin(Q))L ms S p p 
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Appendix G: WAVESIM Program Files 



WAVESIM consists of ten program source code ( . c) files plus three header ( . h) files 
and must be linked to the standard math library. Six of the program source code files and 
two of the header files are specific to WAVESIM while the remaining files contain 
application independent code. 





WAVESIM SPECIFIC FILES 


wavesim . c 


Main Executive Routine 


wavesim . h 


Definition of WAVESIM Structures 


waveinit . c 


Initialization of Structures 
Read device . def 



waveinit . h Define Initial values of all system parameters 



wave re ad . c 


Read and interpret Input File 


wavebld . c 


Build System 


wavewrit . c 


Write MATLAB .M file 


wavewrta . c 


Write MATLAB .M file (continued) 



APPLICATION INDEPENDENT FILES 



ioliba. c 


String Manipulation Routines 


iolbia . h 


declarations of ioliba . c routines 


get_f ile . c 


Prompt for and open files 


get line . c 


Obtain string from an input stream 


f ilebase . c 


File name manipulation routines 
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G-l Main Program File: wavesim. c 



wavesim.c contains the main routine which perfonns the executive functions for 



WAVESIM: 

1. Initialize device definitions 

2. Print the Header 

3. Open Files 

4. Read Input File 

5. Build the System 

6. Write The Output File 

7. Close the Files 



init devices 



read_f ile 
build_system 
write file 
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G-2 System Initialization: waveinit . c 



waveinit . c contains the following routines for initializing the system: 



init devices 


Sets Default Values 

Calls read device def to read in 

device . def file. 

Debug handler. 


read device_def 


Reads in device . def file 


print_system_base 


Prints system base parameters 


print device_def 


Prints a Device Definition 


print matrix 


Prints a Matrix 


print structural jacobian 


Prints a Structural Jacobian 


read terminal 


Interprets TERMINAL subordinate 
command 


read_parameter 


Interprets PARAMETER subordinate 
command 


read state 


Interprets STATE subordinate 

command 


read_function 


Interprets FUNCTION subordinate 
command 


read structural jacobian 


Interprets STRUCTURAL 

JACOBIAN subordinate command 


strip white 


Strips all blanks, tabs, returns from a 
string. 


read matrix 


Reads a matrix. 
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The hierarchy for the routines in waveinit . c is given by 

init_devices 

re ad_de vi c e_de f 
r e ad_t e rmi n a 1 
read_parameter 
read_matrix 
read_state 
read_function 
read_structural_jacobian 
strip_white 
print_system_base 
p r in t_de vi c e_de f 
pr int_xnat r ix 

print_structural_jacobian 
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G-3 Reading Input File: waveread . c 



waveread.c contains the following routines for reading in an input file: 



read file 


Controls other routines for reading 
input files 
Debug handler. 


r ead_f i 1 e_devi c e 


Reads and Interprets device 
command from input file. 


read file_default 


Reads and Interprets default 
command from input file. 


read file node 


Reads and Inteiprets node command 
from input file. 


read file time 


Reads and Interprets time command 
from input file. 


read_f ile_debug 


Reads and Interprets debug 
command from input file. 


print_debug 


Print debug flag status. 


print time 


Print simulation time parameters. 


print device 


Print device characteristics. 


print_system 


Print system characteristics. 


print node 


Print node characteristics. 


finish reading file 


Generate cross references and 

generally finish the process of 
developing the initial system. 
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The hierarchy for the routines in waveread . c is given by: 

read_file 

read_file_device 
print_device 
print_matrix 
read_matrix 
read_file_default 
print_system_base 
r ead_f i le_node 
print_node 
r ead_f i le_t ime 
print_time 
r ead_f i le_debug 
print_debug 
finish_reading_f ile 
print_system 
print_device 
print_node 
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G-4 Building the System: wavebid.c 



wavebld . c contains the following routines for building the system: 



build system 


Identifies System variables and 
equations 

Builds cross references 

Builds System Structural Jacobian 

Reduces system 


build_system_identify 


Identifies system variables and 
equations. 


build system xref 


Builds cross references within the 
system. 


build system_structural_ 


jacobian Builds the system structural 
jacobian matrix. 


build system blocks 


Identifies the sequence of blocks for 
solving system. 


f ind_block 


Attempts to find a block of a given 
size. 


print system_identify 


Prints system information. 


s j_add 


Adds two Structural Jacobian 
codes. 


s j_sub 


Subtracts two Structural Jacobian 
codes. 


print system block sjac 


Prints the block owner of each 
element in the system sructural 
jacobian matrix. 


print_block 


Prints information about a block. 
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The hierarchy for the routines in wavebld. c is given by: 

build_system 

build_system_identify 

print_system_identify 

build_system_xref 

build_system_structural_jacobian 
s j_add 
s j_sub 

print_structural_jacobian 
build_system_blocks 
f ind_block 
print_block 

print_structural_jacobian 
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G-5 Writing MATLAB M-File: wavewrit.c and wavewrta . c 

wavewrit . c and wavewrta . c contain the following routines for writing the 



output MATLAB M-File: 

write_f ile 

wr i t e_f i 1 e_he ade r 
write_f ile_initialize 
write_f ile_time_loop 
write_f ile_plot_variables 
write_f ile_footer 
write file solve block 



Calls other routines to generate 
MATLAB M-File. 

Prints header infonnation to 
MATLAB M-File. 

Prints System Initialization 
parameters to MATLAB M-File. 

Prints Time Loop algorithm to 
MATLAB M-File. 

Prints algorithm to plot system 
variables to MATLAB M-File 

Prints Footer information to 
MATLAB M-File. 

Prints algorithm for solving block to 
MATLAB M-File. 



The hierarchy for the routines in wavewrit . c and wavewrta . c is given by: 

write_f ile 

write_f ile_header 
write_f ile_intialize 
writ e_f i 1 e_t ime_l o op 

write_f ile_solve_block 
write file footer 
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G-6 Application Independent Files 



Several Support files containing special C functions are required by WAVESIM. 
These files were written by the author independently of WAVESIM and may contain 
routines unused by WAVESIM. 

G-6.1 ioliba . c 

ioliba . c contains a number of functions for manipulating strings. The functions 



used by WAVESIM are: 




Stoda 


Converts a string to an array of double precision floating 
numbers. 


strextract 


Extracts the mh word of a string 


strsplit 


Returns the remainder of a string after the nth word. 


strstrip 


Strips a string of leading and trailing spaces, tabs, and 
carriage returns 


strncmpa 


Case insensitive version of strncmp for comparing the 
first n characters of two strings. 


strcmpa 


Case insensitive version of strcmp for comparing two 
strings. 
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G-6.2 getline . c 

getline.c contains functions for reading in lines from a file and automatically 
implementing the following features: 

1. Comment Lines beginning with #, !, or % are ignored. 

2. Blank Lines are ignored. 

3. Lines can be continued with ... or \. 

4. If the first word of the line is INCLUDE followed by a filename, lines are read 
from that file. (NOTE: A check for recursive INCLUDE statements is 
performed to prevent infinite loops) 

5. Carriage Returns are truncated. 

The functions used by WAVESEM are: 
init_strm Initialization function 

get_line Function used to read the lines in. 
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G-6.3 get_f ile . c 

get_file . c contains functions for opening input and output files. The following 
features are implemented: 

1. Two strings are passed: a default filename string and an argument filename 
string. Either or both strings may be empty. 

2. If the argument filename is specified, the functions attempt to open that file. 
If opening that file is unsuccessful, the user is prompted to enter a new 
filename. 

3. If the argument filename is empty, the user is prompted to enter a filename. If 
the default filename is not empty, it is offered to the user as the default name 
of the file. If opening the file entered by the user is unsuccessful, the user is 
prompted to enter a new filename. 

4. Users can exit the routine without opening a file by entering only a q when 
prompted for a filename 

5. Users can obtain a directory listing by entering a ? followed by whatever file 
specification the user desires. 

6. Leading and trailing spaces in filenames are truncated. 

7. Whatever filename is successfully opened is passed back as a new default 
filename. 

The function used by WAVESEM is: 

get_input_f ile Function for opening an Input File 

G-6.4 f ilebase . c 

f ilebase . c contains functions for stripping an extension off of a filename and for 
returning the extension of a filename. The following features are implemented: 

1. An extension is defined as all the characters after the last period (.) found after 
the last directory delimiter (\ for IBM-DOS and / for UNIX). If no such period 
is found, the extension does not exist. 

The function used by WAVESEM is: 

extract__base Extract the base filename (without extension) 
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G-7 Makefile 



The UNIX make utility greatly eases the task of developing programs by only compiling 
those files which have changed since the last compilation. Here is the Makefile used to 
generate WAVESEM on a VAXstation 3100: 

# Makefile for wavesim 

# 

# For Revision 2.0 

# 

FILES = wavesim. c ioliba.c getline.c get_file.c filebase.c \ 
waveinit . c waveread.c wavewrit.c wavewrta.c \ 
wavebld . c 

OBJ = wavesim. o ioliba.o getline.o get__file.o filebase.o \ 
waveinit . o waveread.o wavewrit.o wavewrta.o \ 
wavebld . o 

HEADER= wavesim. h ioliba.h 
CFLAG = -g 
COMPILE = cc 
# 

# 

# 

wavesim: $ (HEADER) $ (OBJ) 

$ (COMPILE) -o wavesim $ (CFLAG) $ (OBJ) -lm 
wavesim. o: $ (HEADER) wavesim. c 

$ (COMPILE) -c $ (CFLAG) wavesim. c 
ioliba.o: ioliba.h ioliba.c 

$ (COMPILE) -c $ (CFLAG) ioliba.c 
getline.o: getline.c 

$ (COMPILE) -c $ (CFLAG) getline.c 
get_file.o: get_file.c 

$ (COMPILE) -c $ (CFLAG) get_file.c 
filebase.o: filebase.c 

$ (COMPILE) -c $ (CFLAG) filebase.c 
waveinit. o: $ (HEADER) waveinit . h waveinit. c 
$ (COMPILE) -c $ (CFLAG) waveinit. c 
waveread.o: $ (HEADER) waveread.c 

$ (COMPILE) -c $ (CFLAG) waveread.c 
wavewrit.o: $ (HEADER) wavewrit.c 

$ (COMPILE) -c $ (CFLAG) wavewrit.c 
wavewrta.o: $ (HEADER) wavewrta.c 

$ (COMPILE) -c $ (CFLAG) wavewrta.c 
wavebld. o: $ (HEADER) wavebld. c 

$ (COMPILE) — c $ (CFLAG) wavebld. c 



# 

# 

# 

lint : 



lint $ (FILES) 
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